{"_id":"@atlasforge/agentforge","_rev":"2-83ccbfa86334155c0868261e466e875e","name":"@atlasforge/agentforge","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@atlasforge/agentforge","version":"1.0.0","keywords":["mcp","model-context-protocol","ai-agent","claude","cursor","windsurf","starter-kit","boilerplate","scaffold","cli"],"author":{"name":"AgentForge"},"license":"MIT","_id":"@atlasforge/agentforge@1.0.0","maintainers":[{"name":"atlasforge","email":"forgea524@agentmail.to"}],"homepage":"https://github.com/thenextfreud/agentforge","bugs":{"url":"https://github.com/thenextfreud/agentforge/issues"},"bin":{"agentforge":"src/index.js"},"dist":{"shasum":"da5e9e947c1683c3b2ae2d263c4f94ada7a04e5f","tarball":"https://registry.npmjs.org/@atlasforge/agentforge/-/agentforge-1.0.0.tgz","fileCount":231,"integrity":"sha512-JFTHaVWzIH3fdUmghhyDe/Dw6cxK7aeFm/fAushrvfxDo9y9nEhJDtcDbOu060uJhXBoCTi9ylLUEoQEGZ6vog==","signatures":[{"sig":"MEUCIE8TdJWtL4Kp85qMqt0rYxlm7pADYajBf2a/qbHqbbScAiEAqUy2QrvWuiH6JFtTesEU5gRHDWbeLLAjVA6k5+vONqU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1194391},"main":"./src/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"6cbd6df3bfdf420e3c74edd3a7a3de9424141a1f","scripts":{"start":"node src/index.js","prepublishOnly":"node scripts/copy-templates.js"},"_npmUser":{"name":"atlasforge","email":"forgea524@agentmail.to"},"repository":{"url":"git+https://github.com/thenextfreud/agentforge.git","type":"git"},"_npmVersion":"10.9.3","description":"Production-ready AI Agent + MCP Server starter kit — scaffold new projects from 15 battle-tested templates.","directories":{},"_nodeVersion":"22.17.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentforge_1.0.0_1788384096238_0.18380926217684168","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@atlasforge/agentforge","version":"1.0.1","description":"Production-ready AI Agent + MCP Server starter kit — scaffold new projects from 15 battle-tested templates.","type":"module","bin":{"agentforge":"src/index.js"},"main":"./src/index.js","scripts":{"start":"node src/index.js","prepublishOnly":"node scripts/copy-templates.js"},"keywords":["mcp","model-context-protocol","ai-agent","claude","cursor","windsurf","starter-kit","boilerplate","scaffold","cli"],"author":{"name":"AgentForge"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/thenextfreud/agentforge.git"},"homepage":"https://github.com/thenextfreud/agentforge","engines":{"node":">=18.0.0"},"_id":"@atlasforge/agentforge@1.0.1","gitHead":"736a987735b6b84b9ab13e328884fd89c7f91c6e","bugs":{"url":"https://github.com/thenextfreud/agentforge/issues"},"_nodeVersion":"22.17.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-G2b5ogWrbh+y3XgHMHu2RcRMDUZkCoJY5qbVY6QMU8WgvyAj3Qvc5Z8Du5gRwMdl3LiBRx0wOrsoRoRQ/60H9g==","shasum":"24bd3ae9fdae48e705ee8aa032c30a6dec6b8fbe","tarball":"https://registry.npmjs.org/@atlasforge/agentforge/-/agentforge-1.0.1.tgz","fileCount":231,"unpackedSize":1194420,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAr69eMVEwaR0/n+0SdKjhR8Be93/Y4/x8B3trcNle6dAiEAnDRU1Zo9Qxee7kNsFaQ2mXBbqZRn8AGIbaPqYpiWrgg="}]},"_npmUser":{"name":"atlasforge","email":"forgea524@agentmail.to"},"directories":{},"maintainers":[{"name":"atlasforge","email":"forgea524@agentmail.to"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentforge_1.0.1_1788384997145_0.22813183463137254"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-02T21:21:36.059Z","modified":"2026-09-02T21:36:37.465Z","1.0.0":"2026-09-02T21:21:36.402Z","1.0.1":"2026-09-02T21:36:37.304Z"},"bugs":{"url":"https://github.com/thenextfreud/agentforge/issues"},"author":{"name":"AgentForge"},"license":"MIT","homepage":"https://github.com/thenextfreud/agentforge","keywords":["mcp","model-context-protocol","ai-agent","claude","cursor","windsurf","starter-kit","boilerplate","scaffold","cli"],"repository":{"type":"git","url":"git+https://github.com/thenextfreud/agentforge.git"},"description":"Production-ready AI Agent + MCP Server starter kit — scaffold new projects from 15 battle-tested templates.","maintainers":[{"name":"atlasforge","email":"forgea524@agentmail.to"}],"readme":"# AgentForge CLI\n\n> Production-ready AI Agent + MCP Server starter kit — scaffold new projects from 15 battle-tested templates.\n\n**Zero dependencies.** Pure Node.js. No external packages required.\n\n## Quick start\n\n```bash\n# Scaffold a new project (interactive)\nnpx @atlasforge/agentforge init my-mcp-server\n\n# Or run directly from this repo\nnode packages/cli/src/index.js init my-mcp-server\n```\n\n## Commands\n\n### `agentforge init [project-name]`\n\nInteractive scaffold command. Walks you through:\n\n1. **Project name** — prompted if not provided as an argument\n2. **Template category** — MCP Server (TypeScript), MCP Server (Python), or AI Agent (TypeScript)\n3. **Template selection** — pick from the templates in your chosen category\n4. **Scaffold** — copies all template files to `./project-name/`\n5. **Next steps** — prints install/run instructions\n\n```bash\n# Provide name upfront\nagentforge init my-server\n\n# Or get prompted\nagentforge init\n```\n\nThe scaffold will:\n- Create the target directory if it doesn't exist\n- Copy all template files (excluding `node_modules`, `dist`, `.env`, `.git`)\n- Update the project name in `package.json` or `pyproject.toml`\n- Print next steps (install, dev, build commands)\n\n### `agentforge list`\n\nList all 15 available templates grouped by category.\n\n```bash\nagentforge list\n```\n\n### `agentforge info <template-id>`\n\nShow detailed info about a specific template: description, tools, language, transport type, required environment variables, and next steps.\n\n```bash\nagentforge info ts-hello-world\n```\n\n### `agentforge --help`\n\nShow the help message with all available commands.\n\n### `agentforge --version`\n\nShow the CLI version.\n\n## Available Templates\n\n### MCP Server Templates (10)\n\n**TypeScript (5):**\n\n| ID | Name | Transport | Description |\n|----|------|-----------|-------------|\n| `ts-hello-world` | Hello World (stdio) | stdio | Minimum viable MCP server with Zod validation |\n| `ts-rest-api-wrapper` | REST API Wrapper | stdio | Wrap any REST API as MCP tools with auth & retries |\n| `ts-database-query` | Database Query Server | stdio | Safe read-only SQL queries with table allow-lists |\n| `ts-filesystem-tools` | Filesystem Tools | stdio | Sandboxed file operations with path traversal prevention |\n| `ts-web-search-fetch` | Web Search & Fetch | stdio | Web search + URL fetching with text extraction |\n\n**Python (5):**\n\n| ID | Name | Transport | Description |\n|----|------|-----------|-------------|\n| `py-rag-knowledge` | RAG Knowledge Server | stdio | Chunk, embed, and vector search with citations |\n| `py-oauth-protected` | OAuth Protected Server | http | Remote MCP server gated by OAuth 2.0 via JWKS |\n| `py-saas-integration` | SaaS Integration Template | stdio | SaaS-wrapping patterns: retries, webhooks, pagination |\n| `py-multi-tool-toolkit` | Multi-Tool Toolkit | stdio | Modular multi-tool server with shared state |\n| `py-streaming-server` | Streaming Server | sse | SSE/Streamable HTTP transport for web deployments |\n\n### AI Agent Templates (5)\n\n| ID | Name | Description |\n|----|------|-------------|\n| `agent-react` | ReAct Agent | ReAct loop: reason, act, observe, repeat |\n| `agent-tool-use` | Tool Use Agent | Structured tool calling with parallel execution |\n| `agent-rag` | RAG Agent | Retrieval-augmented generation with citation |\n| `agent-multi-agent` | Multi-Agent Orchestrator | Coordinator + worker agent orchestration |\n| `agent-human-in-loop` | Human-in-the-Loop Agent | Approval gates for sensitive operations |\n\n## Architecture\n\n```\npackages/cli/\n├── package.json              # npm package config (name: \"@atlasforge/agentforge\")\n├── README.md                 # this file\n├── .gitignore\n└── src/\n    ├── index.js              # entry point, CLI argument parsing\n    ├── commands/\n    │   ├── init.js           # `agentforge init` — interactive scaffold\n    │   ├── list.js           # `agentforge list` — list all templates\n    │   └── info.js           # `agentforge info <id>` — template details\n    └── lib/\n        ├── templates.js      # template registry (all 15 templates)\n        ├── scaffold.js       # copy template files to target directory\n        └── prompts.js        # interactive prompts (readline-based)\n```\n\n## Requirements\n\n- Node.js >= 18.0.0\n\n## License\n\nMIT license. See the project root for details.\n","readmeFilename":"README.md"}