forge-ai-assist
v1.1.15
Published
Install and run Forge Copilot summonables for GitHub discussion analysis.
Maintainers
Readme
Forge
Forge installs GitHub discussion-analysis and issue-analysis runtimes under ~/.copilot, ~/.claude, ~/.codex, and ~/.gemini.
Install
npx forge-ai-assist@latestWhen run in a terminal, Forge will ask whether to install copilot, claude, codex, gemini, or all.
For automation, you can skip the prompt:
npx forge-ai-assist@latest --assistants all
npx forge-ai-assist@latest --assistants copilot
npx forge-ai-assist@latest --assistants claude
npx forge-ai-assist@latest --assistants codex
npx forge-ai-assist@latest --assistants geminiIf npm keeps serving a stale cached release, force an online refresh:
npm_config_prefer_online=true npx forge-ai-assist@latestUse
In Copilot:
- Run
/agent - Select
forge-discussion-analyzerorforge-issue-analyzer - Ask a question about GitHub Discussions or GitHub Issues
For gh copilot, Forge installs matching skills at:
~/.copilot/skills/forge-discussion-analyzer/SKILL.md~/.copilot/skills/forge-issue-analyzer/SKILL.md
This keeps delegation pointed at the same Forge command instead of failing with Skill not found.
In Claude Code:
- Use the installed
forge:discussion-analyzerorforge:issue-analyzercommand - The command delegates to the matching installed agent and the runtime bundle under
~/.claude/forge - Ask a question about GitHub Discussions or GitHub Issues
In Codex:
- Use
$forge-discussion-analyzeror$forge-issue-analyzerfrom~/.codex/skills/ - Codex also gets a matching agent and agent TOML under
~/.codex/agents/ - Ask a question about GitHub Discussions or GitHub Issues
In Gemini:
- Use
forge:discussion-analyzerorforge:issue-analyzerfrom~/.gemini/commands/forge/ - Gemini also gets a matching agent under
~/.gemini/agents/ - Ask a question about GitHub Discussions or GitHub Issues
Custom Instructions
Forge installs:
~/.copilot/agents/forge-discussion-analyzer.agent.md~/.copilot/skills/forge-discussion-analyzer/SKILL.md~/.copilot/agents/forge-issue-analyzer.agent.md~/.copilot/skills/forge-issue-analyzer/SKILL.md~/.claude/commands/forge/discussion-analyzer.md~/.claude/agents/forge-discussion-analyzer.md~/.claude/commands/forge/issue-analyzer.md~/.claude/agents/forge-issue-analyzer.md~/.codex/skills/forge-discussion-analyzer/SKILL.md~/.codex/agents/forge-discussion-analyzer.md~/.codex/agents/forge-discussion-analyzer.toml~/.codex/skills/forge-issue-analyzer/SKILL.md~/.codex/agents/forge-issue-analyzer.md~/.codex/agents/forge-issue-analyzer.toml~/.gemini/commands/forge/discussion-analyzer.toml~/.gemini/agents/forge-discussion-analyzer.md~/.gemini/commands/forge/issue-analyzer.toml~/.gemini/agents/forge-issue-analyzer.md
The markdown assets include a preserved user-customizations block.
- Add your own Copilot instructions inside the
BEGIN USER CUSTOMIZATIONS/END USER CUSTOMIZATIONSsection. - Add your own Claude instructions inside the same markers in the Claude command or agent files.
- Add your own Codex instructions inside the same markers in the Codex skill file.
- Add your own Gemini instructions inside the same markers in the Gemini agent file.
- Leave the Forge-managed section unchanged.
- Upgrades replace only the Forge-managed block, so your custom instructions stay intact across reinstalls and updates.
Notes
forge-discussion-analyzerworks with GitHub Discussions only.forge-issue-analyzerworks with GitHub Issues only.- Analysis traces are written to the repository
.forgedirectory. - Forge installs into
~/.copilot,~/.claude,~/.codex, and~/.gemini. It does not install any files under~/.config/gh. - If Forge hits a network or GitHub API timeout, the installed Copilot agent is expected to report the Forge failure and stop rather than falling back to raw
gh apicalls. - More development and release details are in CONTRIBUTING.md.
