npm package: @joshjal/agent-maker
Description: Generate CLAUDE.md, AGENTS.md, and GEMINI.md files for your project — with AI suggestions and framework scaffolding
Author: Josh Levine
Latest version: 0.1.1

# 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

```bash
npx @joshjal/agent-maker
```

Or install globally:

```bash
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](https://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

```bash
agent-maker
```

### `agent-maker settings`

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

```bash
agent-maker settings
```

### `agent-maker login`

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

```bash
agent-maker login
```

### `agent-maker logout`

Clear stored credentials.

```bash
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](https://agent.task-pilot.dev) and manage them from the web. Sign in first:

```bash
agent-maker login
```

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

## Requirements

- Node.js >= 20

## License

MIT