v1.0.0
2026-03-28
The first official release of ghfs. Mount GitHub Issues as a local filesystem and access them with your favorite tools.
Key Features
FUSE Filesystem
Browse GitHub Issues as a directory tree via FUSE. Use standard tools like cat, grep, find, and jq to work with issues directly. The filesystem is read-only, so there’s no risk of accidental modifications.
Background Sync
A background daemon polls the GitHub API and automatically syncs new and updated issues to your local filesystem. Polling intervals are configurable at both global and per-project levels.
Multi-Profile Support
Switch between multiple GitHub accounts and organizations. Set up each profile with OAuth authentication and manage different repositories per profile.
AI Tool Integration
Works with Claude Code, Cursor, GitHub Copilot, Windsurf, and other AI coding tools. The ghfs rules command generates tool-specific rule files so AI assistants can directly reference local issue files. Structured data (.index.json) enables token-efficient context delivery.
OS Service Registration
Register as a system service on macOS (launchd) or Linux (systemd) for automatic startup at login.
Self-Update
Update to the latest version with ghfs update.
Supported Platforms
- macOS arm64 (Apple Silicon)
- Linux amd64 / arm64
Installation
curl -fsSL https://ghfs.dev/install.sh | sh