agent-maker

Generate CLAUDE.md, AGENTS.md, and GEMINI.md files for your project through an interactive CLI wizard — with AI-powered suggestions and optional framework scaffolding.

Quick Start

npx @joshjal/agent-maker

Or install globally:

npm i -g @joshjal/agent-maker

What It Does

• Interactive wizard — walks you through project name, description, tech stack, code style, commands, and architecture
• AI suggestions — generates project descriptions, tech stack recommendations, and folder structures using Claude
• Framework scaffolding — after generating your config file, optionally scaffold a new project with Next.js, React, Vue, Svelte, and more
• Dashboard sync — save your generated configs to agent.task-pilot.dev and access them from any device
• Multiple formats — generate for Claude Code, Gemini CLI, or the open agents.md standard — or all three at once

Commands

agent-maker (default)

Runs the interactive wizard. Walks you through:

1. Format — CLAUDE.md, AGENTS.md, GEMINI.md, or all three
2. Project overview — name and description (AI can suggest a description)
3. Tech stack — languages, frameworks, package manager, tools
4. Code style — formatter, indentation, quotes, export preferences
5. Commands — install, dev, build, test, lint, type-check (auto-filled from your package manager)
6. Architecture — folder structure and notes (AI can suggest a structure)
7. Review — confirm and generate

agent-maker

agent-maker settings

Configure your API key, sign in to the dashboard, or update the dashboard URL.

agent-maker settings

agent-maker login

Sign in to the web dashboard. Supports browser-based login (Google, GitHub, email) or direct email/password.

agent-maker login

agent-maker logout

Clear stored credentials.

agent-maker logout

Flags

All flags are optional — the wizard will prompt for anything not provided.

| Flag | Description | |------|-------------| | --format <type> | claude, agents, gemini, or all | | --name <name> | Project name | | --api-key <key> | Anthropic API key for AI suggestions | | --output <dir> | Output directory (default: current directory) | | --save | Save to web dashboard after generation | | --no-scaffold | Skip framework scaffolding prompt | | --no-ai | Disable AI suggestions | | --dashboard-url <url> | Override dashboard URL |

AI Suggestions

The wizard can use Claude to suggest project descriptions, tech stacks, and folder structures. An API key is resolved from (in order):

1. --api-key flag
2. ANTHROPIC_API_KEY environment variable
3. Key saved via agent-maker settings

If no key is found, AI features are skipped and the wizard continues without them.

Framework Scaffolding

After the wizard, if you selected a recognized framework, the CLI offers to scaffold a new project using that framework's official CLI. The generated markdown file is placed in the new project's root.

Supported frameworks:

| Framework | Scaffold Command | |-----------|-----------------| | Next.js | create-next-app | | React | create vite (react-ts template) | | Vue | create vue | | Svelte | sv create | | Angular | @angular/cli new | | Nuxt | nuxi init | | Astro | create astro | | Remix | create-remix | | Express | express-generator | | Electron | create electron-vite | | FastAPI | uv init + uv add fastapi | | Django | django-admin startproject | | Flask | uv init + uv add flask | | Rails | rails new | | Phoenix | mix phx.new | | Flutter | flutter create |

The scaffold command respects your chosen package manager (pnpm, npm, yarn, bun).

Dashboard

Save your generated configs to agent.task-pilot.dev and manage them from the web. Sign in first:

agent-maker login

Then use --save or answer "yes" when prompted after generation.

Requirements

• Node.js >= 20

License

MIT