Developer Tool
GitHub Issues as a
Filesystem
ghfs mounts GitHub Issues and Projects via FUSE, turning them into local files. Use cat, grep, jq — the tools you already know — to work with your issues.
$ curl -fsSL https://ghfs.dev/install.sh | sh
AI Integration
Pre-fetched for AI. Zero wasted tokens.
ghfs syncs issues in the background so they're already on disk when your AI needs them. Add one rule to your AI tool's config, and it reads issues as local files — no tool calls, no round-trips, no wasted tokens.
Tell your AI where issues live
Every major AI coding assistant supports project-level rules.
Add a rule pointing to .ghfs/,
and the AI reads pre-fetched issues as ordinary files
— skipping the tool calls it would otherwise make to fetch them.
CLAUDE.md .cursorrules .github/copilot-instructions.md .windsurfrules # Issue Reference
GitHub Issues are mounted at `.ghfs/`.
Always read issues from `.ghfs/github/issues/` as local files.
Never use `gh issue view` or the GitHub API to fetch issue content.Read-only by design
ghfs is strictly read-only. No write operations, no delete operations, no modifications of any kind. No matter what the AI does — even if it hallucinates, runs unexpected commands, or goes off-script — your issues are physically impossible to damage through ghfs. Give your AI full access to issue context, with zero risk.
Measured, not estimated
Investigating a single issue and implementing a fix — 10 runs each with and without ghfs, using Claude Opus 4.6.
tokens saved
AI API calls
faster
10 runs per condition, Claude Opus 4.6, investigating a single issue + implementing a fix.
Features
Manage issues with file operations
FUSE Mount
Mount GitHub Issues as a virtual filesystem. Browse issues as a directory tree on your local machine.
Standard Tool Integration
Use cat, grep, find, jq, and any other command-line tool to work with issues directly.
AI-Ready
Feed issue context directly to AI tools like Claude Code and Cursor. They can read issues as files.
Read-Only
No risk of accidentally modifying issues from your local machine. Browse safely.
Multi-Profile
Switch between multiple GitHub accounts and organizations seamlessly.
Background Sync
A daemon syncs data in the background on a schedule. Always see the latest issues.
Use Cases
Built for real workflows
Give AI assistants full issue context
Claude Code and Cursor can read issue content directly as files. Just say "implement this issue" and the AI already knows every detail, comment, and label.
# AI reads issue context from your project
$ cat .ghfs/github/issues/42-Add_OAuth2.md
---
number: 42
title: Add OAuth2 authentication
state: open
labels: [feature, auth]
---
We need to support Google and GitHub OAuth...
$ claude "Implement issue #42"
# → Reads .ghfs/github/issues/42-*
# → Starts coding with full contextSearch across all issues with grep
Find what you need across every issue instantly. No clicking through browser tabs one by one. Pipe, redirect, and transform however you like.
# Find issues mentioning "memory leak"
$ grep -rl "memory leak" .ghfs/github/issues/
.ghfs/github/issues/87-Fix_memory_leak.md
.ghfs/github/issues/198-GC_improvement.md
# Search by label in frontmatter
$ grep -l "bug" .ghfs/github/issues/*.mdAutomate issue workflows with shell scripts
Read issue data programmatically to generate reports, export to spreadsheets, or build dashboards. No API wrappers needed.
# List all issue files
$ ls .ghfs/github/issues/
42-Add_OAuth2.md
87-Fix_memory_leak.md
123-Dark_mode.md
# Extract titles from frontmatter
$ grep "^title:" .ghfs/github/issues/*.md
42-Add_OAuth2.md:title: Add OAuth2 authentication
87-Fix_memory_leak.md:title: Fix memory leak
123-Dark_mode.md:title: Dark mode supportPricing
Simple, transparent pricing
All prices in USD. Cancel anytime.
Free
Get started for free
No credit card required
- Issues (latest 10)
- 1 project
- Community support
- Projects
- Discussions
- Pull Requests
Hobby
For individual developers
$48/yr (save 20%)
- Issues (all)
- Unlimited projects
- Background sync
- Email support
- Projects
- Discussions
- Pull Requests
Pro
Full access to all features
$108/yr (save 25%)
- Issues (all)
- Projects
- Discussions
- Pull Requests
- Unlimited projects
- Priority support
Enterprise
For teams and organizations
- Everything in Pro
- Team license management
- Dedicated support
- SLA guarantee
We accept Visa · Mastercard · American Express
Payments processed securely. See our Legal Notice.
Roadmap
What's next
We're actively building. Here's what's coming.
Smart Query Files
Filter issues by state, label, date, or author using filenames as queries. Read only what you need — no more loading everything at once.
Semantic Search
Search issues by meaning, not just keywords. Powered by Embedding AI, find "authentication problems" even when issues say "login error". Available as a paid add-on for Pro and Enterprise tiers.
IDE Plugins
First-class integration with VSCode and JetBrains IDEs. Manage the daemon and browse issues without leaving your editor.
Projects, Discussions & Pull Requests
Browse GitHub Projects, Discussions, and Pull Requests as files — not just Issues.
Windows Support
Bring ghfs to Windows with WinFSP integration. Mount your issues on any platform.
Jira & Other Ticket Systems
Not just GitHub. We're exploring support for Jira, Linear, and other issue trackers as mountable filesystems.
Deleted Issue Cleanup
Automatically remove deleted or transferred issues from your local mount. Essential for compliance, data retention policies, and reducing information exposure risk.
Ready to try it?
Install ghfs and start browsing GitHub Issues as local files.