README file from
GithubAtPath
Reference any file in your vault with @path/to/file or [[wikilinks]] — bridging AI coding tools and Obsidian's native link graph.
Autocomplete, click-to-open, token counting, one-click publish to the web, and cross-repo support.
Features
@ Autocomplete
Type @ and pick any file. Works across repos — files from the current repo appear first, then cross-repo matches (@other-repo/src/file.py), then loose vault files.
Wikilink format
The plugin optionally wraps references as [[path|@display]], giving you full integration with Obsidian's graph view, backlinks, and automatic rename tracking while keeping the @ visual style. The link path respects your "New link format" vault setting (shortest path when possible, relative, or absolute). A settings toggle lets you choose between legacy @path (agent-friendly, plain text) and the wikilink format. Both formats work everywhere: Live Preview, Reading mode, token counts, copy to clipboard, and publish. Migration commands let you convert existing @path references to wikilinks in bulk.
Clickable Links
Click any @path in Live Preview or Reading mode to open the file inside Obsidian. Right-click to open in your default external app.
Token Counts
See how many tokens each @path reference adds — inline badges and a status bar total. Uses the GPT-4o tokenizer as an estimate. Click the status bar to copy everything to clipboard.
Copy Note + @path Contents
One command (or click the status bar) to copy the current note with all referenced file contents appended — ready to paste into any web LLM. Each file appears under a ## @path header in fenced code blocks.
Publish to Vercel
Deploy notes and standalone HTML apps to Vercel with one click. Notes can publish linked @path content, while .html files in the File Explorer can publish either as a single-file app or as a whole folder-based static site.
Private publishing is supported through Clerk, and the publish flow also stores a reusable site icon so your deployed pages can show a favicon in browser tabs without asking every time.
Before publishing, the confirmation modal shows the target domain, current publish state, linked @path notes when relevant, and the main publish options for that content type.
After deploying, a result modal gives you the URL with Copy and Open in browser buttons.
Published pages include collapsible sections, foldable bold list items, inlined local images, a download button, and a configurable contact button.
Cross-Repo References
Reference files across different repos with @reponame/path/to/file.ext. Renames propagate automatically. Inside _repos/, paths are repo-relative; the first segment of a cross-repo path is matched against known repo names.
Auto-Update References
Rename or move a file and all @path references across the vault update automatically — same-repo, cross-repo, and vault-relative formats.
Settings
| Setting | Default | Description |
|---|---|---|
| Show token counts | On | Inline badges + status bar total |
| Max file size (MB) | 5 | Skip token counting above this |
| Vercel API token | — | For one-click publishing |
| Contact URL | — | Button link on published pages |
| Preferred insert format | Legacy @path | Wikilink ([[path|@display]]) or legacy @path |
| Contact button label | Entre em contato | Button text |
| Clerk publishable key | — | Required for private publishing |
| Clerk secret key | — | Required for private publishing |
| Publisher email | — | Used in private access requests |
| Site icon | — | Reusable favicon for published notes and HTML apps |
Install
- Community Plugins — not listed in the official Obsidian Community Plugins catalog as of April 2, 2026
- BRAT — install
BRATfrom Obsidian Community Plugins, openSettings->BRAT, chooseAdd beta plugin, enterhttps://github.com/sergiogportela/obsidian-atpath, then enableAtPath - Release zip — download
atpath-x.y.z.zipfrom the latest release, extract it into.obsidian/plugins/so it creates.obsidian/plugins/atpath/, then enable or reload the plugin - Manual — copy
main.js,manifest.json,styles.cssto.obsidian/plugins/atpath/, then enable or reload the plugin
Contributing
Contributions are welcome! Feel free to open issues or submit pull requests.
License
MIT