ghfs CLI
ghfs keeps GitHub issues and pull requests as Markdown files so an agent can read them offline and edit them in bulk
- 283 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- `ghfs execute --run` closes issues, changes labels and posts comments as your account.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/ghfsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- `ghfs execute --run` closes issues, changes labels and posts comments as your account.
This is third-party code. Review the repository files before installing.
What it does
Run `ghfs` inside a repository and it writes open issues and pull requests to a `.ghfs` directory: `issues.md` and `pulls.md` indexes, one file per item, patches for PRs. An agent reads those files offline and summarises them. Edits do not reach GitHub at once. They queue in `execute.md` or `execute.yml`, or as frontmatter changes in the item files (title, state, labels, assignees, milestone). `ghfs execute` prints a report and `ghfs execute --run` applies the queue. A local web UI (`ghfs ui`) and a multi-project dashboard (`ghfs hub`) are included.
Who it is for. Maintainers with a heavy issue and PR flow who triage with an agent and want to review changes before they are sent.
Good fit when
- You need to triage a hundred open issues and close duplicates in one pass.
- An agent should read discussions without calling the API for every question.
- Labels and assignees follow rules, and you review the result by eye.
- You run several repositories and want one list of recent discussions.
Not a fit when
- You need a stable tool: the README itself says the project is still in development.
- A single reply in the browser is enough.
- The team does not want a copy of discussions in a working directory.
Example request
Sync issues, find duplicates among the open ones and queue a close with a comment, but do not run `execute --run`.Limitations
The README opens with a warning that the project is under development and not yet usable. Commands and file formats may change. The export lands inside the repository directory, so add `.ghfs` to `.gitignore` if you do not want discussions committed. Label suggestions via `ghfs label` need a Vercel AI Gateway key and send item text to an external model. GitHub saved replies from `github.com/settings/replies` are not synced because they have no public API.
How to disable. Remove the skill from the agent skills directory and delete the `.ghfs` directory. A queue left without `--run` sends nothing.
FAQ
What changes on GitHub after I edit a file?
Nothing until `ghfs execute --run`. Without the flag the command only reports which operations would run.
How do I install the skill?
`pnpx skills add antfu/ghfs` installs the skill from `skills/ghfs`. The `@ghfs/cli` package also ships skills for `skills-npm`.
Can I browse issues without the terminal?
Yes. `ghfs ui` opens a two-pane view on port 7710, and edits made there also go into the queue.
Do I need a GitHub credential?
Access to GitHub needs authorisation like any tool that reads issues and applies edits. Check the setup section of the README for the method.
What does `ghfs label` do?
It asks a model to suggest labels for unlabeled items based on labeled examples and queues the suggestions without sending anything to GitHub.
Discussion
No questions or reviews yet.
Related
CLI toolsA Go tool for GitHub issues: Markdown files on disk that an agent edits in bulk and the push command sends back.
The terminal GitHub dashboard shows issues and pull requests so users can review agent work in configurable sections.
A GitHub CLI and skill that maps linked issues and PRs, surfacing competing fixes and unresolved follow-ups before you start.
A skill with four gh scripts that gives an agent pull request state, review threads and CI failures in one call and short output.
The GitHub CLI extension gh stack and an agent skill: a chain of dependent branches and PRs with rebase, submit and merge of the whole stack
A GitHub CLI extension and agent skill that uploads screenshots, PDFs, archives and logs to issues and pull requests and returns a ready link
README in short
A filesystem mirror of GitHub for offline reading and batch operations, built for humans and agents.