{"_id":"@0x0r10n/forge-ai","_rev":"3-40360ebe75811f701b337c80ba9dfda3","name":"@0x0r10n/forge-ai","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@0x0r10n/forge-ai","version":"1.0.0","keywords":["forge","forge-ai","ai","coding-agent","terminal","cli","deepseek","llm","multi-agent","rag","developer-tools","typescript","bun"],"author":{"name":"Forge AI Contributors"},"license":"MIT","_id":"@0x0r10n/forge-ai@1.0.0","maintainers":[{"name":"0x0r10n","email":"codexrage@gmail.com"}],"homepage":"https://github.com/forge-ai/forge#readme","bugs":{"url":"https://github.com/forge-ai/forge/issues"},"bin":{"forge":"dist/forge.js"},"dist":{"shasum":"7b35a9cfaeef55f499c5f15aaab82e80644413dd","tarball":"https://registry.npmjs.org/@0x0r10n/forge-ai/-/forge-ai-1.0.0.tgz","fileCount":5,"integrity":"sha512-IS0BMCXNAy9wCsNrtqkorASEf44HC5xmQEYf3D46pWGtH0xAvAyFsMo9ZubkiVGY4ILuznKVbeAdQRK3xmtx7A==","signatures":[{"sig":"MEUCIEZEckJANS/P4ZN8XMNuT9DXdQQtrVRSX6fZ2O0rsJZ1AiEA2Ih22Wmbj/o0gJwLyhnQk69ySuM8lsgjn3Ctof7VIU4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2507591},"type":"module","engines":{"bun":">=1.0.0","node":">=18.0.0"},"gitHead":"cef88f1fabea97a3d77f340f32638d96895375a6","scripts":{"dev":"bun --watch src/index.ts","lint":"tsc --noEmit","build":"bun build src/index.ts --outfile dist/forge.js --target node --external react-devtools-core && node scripts/prepend-shebang.mjs && chmod +x dist/forge.js","start":"bun src/index.ts","typecheck":"tsc --noEmit","postinstall":"node -e \"const fs=require('fs');const d='node_modules/react-devtools-core';if(!fs.existsSync(d)){try{fs.mkdirSync(d,{recursive:true});fs.writeFileSync(d+'/package.json',JSON.stringify({name:'react-devtools-core',version:'0.0.0',main:'index.js'}));fs.writeFileSync(d+'/index.js','module.exports={};');}catch(e){}}\"","prepublishOnly":"bun run build && bun run typecheck"},"_npmUser":{"name":"0x0r10n","email":"codexrage@gmail.com"},"overrides":{"react":"^18.3.1","react-dom":"^18.3.1"},"repository":{"url":"git+https://github.com/forge-ai/forge.git","type":"git"},"_npmVersion":"11.6.2","description":"Forge is a powerful open-source multi-agent coding agent for the terminal. Built for speed, cost-efficiency, and full control using DeepSeek models.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ink":"^5.1.0","zod":"^3.23.8","glob":"^11.0.0","chalk":"^5.4.1","react":"^18.3.1","dotenv":"^16.4.5","openai":"^4.67.3","commander":"^12.1.0","ink-spinner":"^5.0.0","ink-text-input":"^5.0.1","ink-select-input":"^5.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.6.3","@types/node":"^22.0.0","@types/react":"^18.3.11"},"_npmOperationalInternal":{"tmp":"tmp/forge-ai_1.0.0_1779798864613_0.6396176053666904","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@0x0r10n/forge-ai","version":"1.0.1","keywords":["forge","forge-ai","ai","coding-agent","terminal","cli","deepseek","llm","multi-agent","rag","developer-tools","typescript","bun"],"author":{"name":"Forge AI Contributors"},"license":"MIT","_id":"@0x0r10n/forge-ai@1.0.1","maintainers":[{"name":"0x0r10n","email":"codexrage@gmail.com"}],"homepage":"https://github.com/0x0r10n/forge-ai#readme","bugs":{"url":"https://github.com/0x0r10n/forge-ai/issues"},"bin":{"forge":"dist/forge.js"},"dist":{"shasum":"a6fe92f19b83e69a7dd19f139a08bc701f0cd13d","tarball":"https://registry.npmjs.org/@0x0r10n/forge-ai/-/forge-ai-1.0.1.tgz","fileCount":5,"integrity":"sha512-1oxM77PF9rckweQRR1rdWRrLxdrT/Ru1/bBqDgim1eiWAsGO7IprQWvQwGgz5KOYPZLRt/1QQsFZ7tDZCqH27Q==","signatures":[{"sig":"MEQCIF6qoFzMG2U7vBhql36LMVu47pBlfE+hy29/Rt3nBwP9AiB2wtCNE+rYqQFquBMc+IhHwc54wyT1lZW4ypQaD/io3g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2507664},"type":"module","engines":{"bun":">=1.0.0","node":">=18.0.0"},"gitHead":"4163d7def731a5b4deb9f46c6e7ed05427b68887","scripts":{"dev":"bun --watch src/index.ts","lint":"tsc --noEmit","build":"bun build src/index.ts --outfile dist/forge.js --target node --external react-devtools-core && node scripts/prepend-shebang.mjs && chmod +x dist/forge.js","start":"bun src/index.ts","typecheck":"tsc --noEmit","postinstall":"node -e \"const fs=require('fs');const d='node_modules/react-devtools-core';if(!fs.existsSync(d)){try{fs.mkdirSync(d,{recursive:true});fs.writeFileSync(d+'/package.json',JSON.stringify({name:'react-devtools-core',version:'0.0.0',main:'index.js'}));fs.writeFileSync(d+'/index.js','module.exports={};');}catch(e){}}\"","prepublishOnly":"bun run build && bun run typecheck"},"_npmUser":{"name":"0x0r10n","email":"codexrage@gmail.com"},"overrides":{"react":"^18.3.1","react-dom":"^18.3.1"},"repository":{"url":"git+ssh://git@github.com/0x0r10n/forge-ai.git","type":"git"},"_npmVersion":"11.6.2","description":"Forge is a powerful open-source multi-agent coding agent for the terminal. Built for speed, cost-efficiency, and full control using DeepSeek models.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"ink":"^5.1.0","zod":"^3.23.8","glob":"^11.0.0","chalk":"^5.4.1","react":"^18.3.1","dotenv":"^16.4.5","openai":"^4.67.3","commander":"^12.1.0","ink-spinner":"^5.0.0","ink-text-input":"^5.0.1","ink-select-input":"^5.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.6.3","@types/node":"^22.0.0","@types/react":"^18.3.11"},"_npmOperationalInternal":{"tmp":"tmp/forge-ai_1.0.1_1779799392068_0.872208264833358","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@0x0r10n/forge-ai","version":"1.0.2","description":"Forge is a powerful open-source multi-agent coding agent for the terminal. Built for speed, cost-efficiency, and full control using DeepSeek models.","type":"module","bin":{"forge-ai":"dist/forge.js"},"scripts":{"start":"bun src/index.ts","dev":"bun --watch src/index.ts","build":"bun build src/index.ts --outfile dist/forge.js --target node --external react-devtools-core && node scripts/prepend-shebang.mjs && chmod +x dist/forge.js","prepublishOnly":"bun run build && bun run typecheck","postinstall":"node -e \"const fs=require('fs');const d='node_modules/react-devtools-core';if(!fs.existsSync(d)){try{fs.mkdirSync(d,{recursive:true});fs.writeFileSync(d+'/package.json',JSON.stringify({name:'react-devtools-core',version:'0.0.0',main:'index.js'}));fs.writeFileSync(d+'/index.js','module.exports={};');}catch(e){}}\"","typecheck":"tsc --noEmit","lint":"tsc --noEmit"},"keywords":["forge","forge-ai","ai","coding-agent","terminal","cli","deepseek","llm","multi-agent","rag","developer-tools","typescript","bun"],"author":{"name":"Forge AI Contributors"},"license":"MIT","repository":{"type":"git","url":"git+ssh://git@github.com/0x0r10n/forge-ai.git"},"homepage":"https://github.com/0x0r10n/forge-ai#readme","bugs":{"url":"https://github.com/0x0r10n/forge-ai/issues"},"engines":{"node":">=18.0.0","bun":">=1.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"dependencies":{"chalk":"^5.4.1","commander":"^12.1.0","dotenv":"^16.4.5","glob":"^11.0.0","ink":"^5.1.0","ink-select-input":"^5.0.0","ink-spinner":"^5.0.0","ink-text-input":"^5.0.1","openai":"^4.67.3","react":"^18.3.1","zod":"^3.23.8"},"devDependencies":{"@types/bun":"latest","@types/node":"^22.0.0","@types/react":"^18.3.11","typescript":"^5.6.3"},"overrides":{"react":"^18.3.1","react-dom":"^18.3.1"},"gitHead":"646c14de269e2cd632b51c1cae05d71d38db53e1","_id":"@0x0r10n/forge-ai@1.0.2","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-UPLUq0XuRtp6Vj+WqVvkwC6vSKiJ/yfFcZE58nZfnu6sZsMdABUML15oC8WH/wtl942TSd7gO8anwKk7y1YYvg==","shasum":"845327fcb6f37e901971b32343927cdeb53a05b6","tarball":"https://registry.npmjs.org/@0x0r10n/forge-ai/-/forge-ai-1.0.2.tgz","fileCount":5,"unpackedSize":2507802,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICG7ffE4AQ4Mpm16Tt1+4avgt0UC2r+jCPmlbbYQ1dkrAiACKWPFAKKIlxYgMqIhRPuamEMRE9FnYQ70JCAChJ7Uew=="}]},"_npmUser":{"name":"0x0r10n","email":"codexrage@gmail.com"},"directories":{},"maintainers":[{"name":"0x0r10n","email":"codexrage@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/forge-ai_1.0.2_1779800077020_0.5487161724736356"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-26T12:34:24.511Z","modified":"2026-05-26T12:54:37.328Z","1.0.0":"2026-05-26T12:34:24.775Z","1.0.1":"2026-05-26T12:43:12.240Z","1.0.2":"2026-05-26T12:54:37.235Z"},"bugs":{"url":"https://github.com/0x0r10n/forge-ai/issues"},"author":{"name":"Forge AI Contributors"},"license":"MIT","homepage":"https://github.com/0x0r10n/forge-ai#readme","keywords":["forge","forge-ai","ai","coding-agent","terminal","cli","deepseek","llm","multi-agent","rag","developer-tools","typescript","bun"],"repository":{"type":"git","url":"git+ssh://git@github.com/0x0r10n/forge-ai.git"},"description":"Forge is a powerful open-source multi-agent coding agent for the terminal. Built for speed, cost-efficiency, and full control using DeepSeek models.","maintainers":[{"name":"0x0r10n","email":"codexrage@gmail.com"}],"readme":"<div align=\"center\">\n\n# Forge AI\n\n## Forge better code. Faster.\n\n**Open-source multi-agent coding agent for the terminal. Built for speed, cost-efficiency, and operator control with DeepSeek models.**\n\n[![npm version](https://img.shields.io/npm/v/@0x0r10n/forge-ai?color=cyan&label=@0x0r10n/forge-ai)](https://www.npmjs.com/package/@0x0r10n/forge-ai)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Bun](https://img.shields.io/badge/runtime-Bun-orange)](https://bun.sh)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue)](https://www.typescriptlang.org/)\n\n</div>\n\n---\n\n## What Forge AI Is\n\nForge AI is a terminal-first coding agent with a built-in multi-agent workflow:\n\n- **Architect** plans the change.\n- **Coder** implements and runs checks.\n- **Reviewer** validates for quality and correctness.\n\nIt also includes local semantic code search (TF-IDF), persistent project memory, checkpoint/rollback, and quality gates for safer iteration.\n\n---\n\n## Capability Snapshot\n\n| Capability | Forge AI | Cursor Composer 2.5 | Claude Code |\n|---|:---:|:---:|:---:|\n| Multi-agent pipeline (Architect → Coder → Reviewer) | ✅ | ⚠️ Varies by workflow | ❌ |\n| Local semantic search (TF-IDF RAG) | ✅ | ✅ | ❌ |\n| Project memory (local) | ✅ | ⚠️ Limited | ✅ |\n| Checkpoint and rollback | ✅ | ❌ | ❌ |\n| Terminal-native workflow | ✅ | ⚠️ Hybrid | ✅ |\n| Open-source core | ✅ | ❌ | ❌ |\n| Model routing controls | ✅ | ⚠️ Limited | ⚠️ Limited |\n\nNotes:\n- Table reflects current Forge AI features in this repository.\n- Competitor columns are a practical high-level snapshot and may evolve over time.\n\n---\n\n## Install\n\n```bash\nnpm install -g @0x0r10n/forge-ai\n# or\nbun add -g @0x0r10n/forge-ai\n```\n\n---\n\n## Quickstart\n\n```bash\n# one-time setup\nforge-ai setup\n\n# interactive mode\nforge-ai\n\n# start with a task\nforge-ai \"add JWT authentication to my Express app\"\n```\n\nVerify setup:\n\n```bash\nforge-ai doctor\n```\n\n---\n\n## CLI Commands\n\n| Command | Description |\n|---|---|\n| `forge-ai setup` | Configure API key and defaults |\n| `forge-ai config` | View/update configuration |\n| `forge-ai models` | Show available model options |\n| `forge-ai doctor` | Run environment and dependency checks |\n| `forge-ai update` | Update global install |\n\n---\n\n## Slash Commands\n\n| Command | Description |\n|---|---|\n| `/multi <task>` | Run Architect → Coder → Reviewer pipeline |\n| `/oneshot <task>` | Run pipeline and exit with CI-friendly status |\n| `/think <question>` | Force deeper reasoning model |\n| `/checkpoint [label]` | Snapshot project files |\n| `/commit [hint]` | Generate smart conventional commit |\n| `/memory [query]` | Recall saved project memory |\n| `/reindex` | Rebuild semantic index |\n| `/report [days]` | Usage report |\n| `/status` | Session status |\n| `/ship` | Run production quality gate |\n| `/cost` | Quick token usage display |\n| `/clear` | Clear session history |\n| `/help` | Show command list |\n\n---\n\n## Quality Gate\n\nForge AI includes a built-in ship gate (`/ship`) that checks local release readiness:\n\n- git cleanliness (when in a git repo)\n- typecheck (if script exists)\n- lint (if script exists)\n- tests (if script exists)\n- build (if script exists)\n\nThis is designed to reduce “looks good but fails in CI” outcomes.\n\n---\n\n## Configuration\n\nConfig location:\n\n```text\n~/.forge/config.json\n```\n\nExample:\n\n```json\n{\n  \"apiKey\": \"sk-...\",\n  \"defaultModel\": \"deepseek-chat\",\n  \"autoRouteModels\": true,\n  \"autoIndexOnStartup\": true,\n  \"requireConfirmationForDangerous\": true,\n  \"maxIterations\": 30\n}\n```\n\n---\n\n## Current Scope and Limits\n\nWhat is production-usable now:\n\n- terminal workflow and slash command surface\n- multi-agent orchestration\n- local TF-IDF semantic search\n- memory/checkpoint storage under `~/.forge`\n- packaging as `@0x0r10n/forge-ai` with `forge-ai` binary\n\nKnown limits:\n\n- no MCP integration yet\n- no native web retrieval tool by default\n- benchmark/comparison claims are not a formal public benchmark suite\n\n---\n\n## Development\n\n```bash\ngit clone git@github.com:0x0r10n/forge-ai.git\ncd forge-ai\nbun install\nbun run typecheck\nbun run build\nbun dev\n```\n\n---\n\n## License\n\n[MIT](LICENSE) © Forge AI Contributors\n","readmeFilename":"README.md"}