Hypha VS Code Extension
VS Code integration for Hypha markdown notes.
Prerequisites
- Hypha CLI installed and in your
PATH
- VS Code 1.85 or later
Features
- Topic list with configurable frontmatter badges and sorting
- Filter with field filters (
status:active, tags:work)
- Find Topic with fuzzy title and metadata search
- Search Content to find text within note bodies
- Backlinks view showing topics that link to selected topic
- Warning icons for topics with lint issues
- Auto-sync — Highlights current file in tree
Commands
| Command |
Keybinding |
Description |
| Focus Sidebar |
Cmd+K O |
Focus the Hypha topics view |
| New Topic |
Cmd+K N |
Create a new topic |
| Find Topic |
Cmd+K F |
Find topic by title or metadata |
| Filter View |
Cmd+K Shift+F |
Filter sidebar with query |
| Search Content |
Cmd+K S |
Search within note content |
| Clear Filter |
Cmd+K C |
Clear filter |
| Refresh |
Cmd+K R |
Refresh topic list |
| Lint |
Cmd+K L |
Check for issues |
| Info |
Cmd+K I |
Show statistics |
On Windows/Linux, use Ctrl instead of Cmd.
Right-click a topic for:
- Find Backlinks — Show topics linking to this one
- Copy Markdown Link — Copy
[Title](https://github.com/battagel/hypha/blob/HEAD/filename.md)
- Copy Relative Path — Copy
filename.md
- Rename Topic — Rename and update all references
- Delete Topic — Remove the topic file
Diagnostics
Lint warnings appear in the Problems panel with clickable locations for:
- Missing titles
- Empty content
- Broken links
Configuration
| Setting |
Description |
Default |
hypha.displayFields |
Frontmatter fields to show as badges |
[] |
hypha.maxBadges |
Maximum badges per topic |
3 |
hypha.binaryPath |
Path to hypha binary |
hypha |
hypha.rootDir |
Notes directory (auto-detected from CLI config) |
— |
hypha.sortOrder |
Sort order: alpha, modified, created |
alpha |
Development
npm install
npm run watch # Compile on change
npm run lint # Check for issues
Press F5 to launch Extension Development Host.
Architecture
The extension is a thin wrapper around the Hypha CLI:
- Spawns
hypha commands with JSON output flags
- Parses JSON responses
- Presents results in VS Code UI
No business logic — all functionality comes from the CLI.
See Architecture for details.
| |
