ClaudeTools CLI

A command-line toolkit for AI-assisted project onboarding and documentation generation. ClaudeTools automatically detects your tech stack, generates comprehensive documentation, and creates context files that help AI agents like Claude Code understand your codebase.

Installation

npm install -g @claudetools/cli

Requirements:

• Node.js 18.0.0 or higher
• Optional: Claude CLI for AI-powered analysis
• Optional: mcp-cli for Context7 documentation fetching

Quick Start

# Navigate to your project
cd my-project

# Run the onboarding wizard
claudetools onboard

That's it. ClaudeTools will analyze your project, ask a few questions, and generate everything needed for AI-assisted development.

Commands

claudetools onboard

The primary command. Runs a 4-phase onboarding workflow that analyzes your project and generates comprehensive AI context.

claudetools onboard [options]

Options:

Examples:

# Standard onboarding
claudetools onboard

# Refresh existing documentation
claudetools onboard --refresh

# Quick run without docs
claudetools onboard --skip-docs

claudetools init

Minimal setup that creates the .claude/ directory structure without the full onboarding process.

claudetools init

claudetools cleanup

Removes legacy configuration files from previous versions.

claudetools cleanup

Global Options

claudetools --version    # Show version and check for updates
claudetools --help       # Show help message

How It Works

Phase 1: Stack Detection

ClaudeTools scans your project for manifest files and automatically detects:

• Package Managers: npm, pnpm, yarn, bun, pip, poetry, go modules, cargo
• Frameworks: React, Vue, Next.js, Nuxt, Astro, Express, FastAPI, NestJS, and 25+ more
• Libraries: Database (Prisma, Drizzle), State Management (Zustand, Redux), UI Components (Radix, shadcn/ui), and 40+ categories
• Dev Tools: TypeScript, ESLint, Prettier, Vitest, Jest, Playwright

Supported manifest files:

• package.json (JavaScript/TypeScript)
• requirements.txt, pyproject.toml (Python)
• go.mod (Go)
• Cargo.toml (Rust)

Phase 2: Quick Questions

An interactive prompt gathers context about your project:

1. "What do you want to build?" — Brief project description
2. "What are you working on right now?" — Current focus area
3. "Anything else Claude should know?" — Additional context

For new/empty projects, additional questions include:

• Project type selection (Web App, API, CLI, Library, Full-stack)
• AI-generated follow-up questions tailored to your project

All questions are optional (except project description for new projects). Press Enter to skip.

Phase 3: AI Analysis & Proposal

If the Claude CLI is installed, ClaudeTools uses it to:

1. Analyze your codebase and generate a stack summary
2. Propose a configuration including frameworks, libraries, architecture
3. Accept feedback and refine the proposal iteratively

For new/empty projects, it will:

• Recommend a complete tech stack based on your description
• Offer to scaffold the project (create package.json, install dependencies)

Approval workflow:

┌─ Proposed Configuration ────────────────
│
│  A task management CLI with local storage
│
│  Frameworks: commander, ink
│  Libraries: chalk, conf, ora
│  Dev Tools: typescript, vitest, tsup
│  Architecture: CLI with command pattern
│
│  Recommendations:
│  • Use commander for argument parsing
│  • Store data in ~/.config with conf
│  • Add --json flag for scriptability
│
└──────────────────────────────────────────

? How does this look?
  ❯ Looks good, proceed
    I have feedback
    Skip AI analysis

Phase 4: Documentation Generation

ClaudeTools generates comprehensive documentation:

1. Fetches official docs via Context7 MCP for all detected libraries
2. Creates organized documentation in .claudetools/docs/
3. Generates AGENTS.md — the primary AI context file

Output Structure

After running claudetools onboard, your project will have:

project-root/
├── AGENTS.md                    # Primary AI context file
├── .claude/
│   └── CLAUDE.md                # Pointer to AGENTS.md
└── .claudetools/
    └── docs/
        ├── index.md             # Documentation hub
        ├── architecture/
        │   ├── index.md
        │   ├── system-design.md
        │   ├── data-flow.md
        │   └── components.md
        ├── api/
        │   ├── index.md
        │   └── endpoints.md
        ├── guides/
        │   ├── getting-started.md
        │   ├── development.md
        │   └── contributing.md
        ├── reference/
        │   ├── configuration.md
        │   └── environment.md
        ├── patterns/
        │   ├── coding-standards.md
        │   └── naming-conventions.md
        ├── testing/
        │   └── strategy.md
        ├── deployment/
        │   └── environments.md
        └── libraries/
            ├── index.md
            ├── react.md         # Framework-specific docs
            └── [library].md     # Library-specific docs

AGENTS.md

The primary AI context file contains:

• Project Overview: Name, description, and key technologies
• Stack Summary: Detected frameworks, libraries, and dev tools
• Directory Structure: Project tree (up to 4 levels)
• Entry Points: Main files and their purposes
• Conventions: Detected coding patterns and standards
• Documentation Links: References to generated docs

This file is designed to be read by AI agents at the start of a session to understand your project quickly.

New Project Support

ClaudeTools fully supports empty/new projects:

mkdir my-new-project
cd my-new-project
claudetools onboard

For new projects, ClaudeTools will:

1. Ask what you want to build (required)
2. Ask the project type (web, api, cli, library, fullstack)
3. Generate AI-powered follow-up questions specific to your project
4. Recommend a complete tech stack
5. Offer to scaffold the project:
   • Create package.json with recommended dependencies
   • Detect and use your preferred package manager (pnpm, bun, yarn, npm)
   • Install dependencies automatically
6. Generate AGENTS.md with the proposed configuration

Example flow:

▸ Phase 1/4: Stack Detection
  ℹ New project - let's set it up

▸ Phase 2/4: Quick Questions

    ┌─ Quick Context ───────────────────────
    │
    │  New project setup
    │  Tell us what you want to build.
    │
    └──────────────────────────────────────────

? What do you want to build? A REST API for managing bookmarks
? What type of project? API/Backend (Express/Fastify)
? What are you working on right now? Setting up the project structure

    ┌─ A few more questions ─────────────────
    │
    │  These will help tailor the stack.
    │
    └──────────────────────────────────────────

? Which database will you use? PostgreSQL
? Do you need user authentication? Yes, JWT-based

▸ Phase 3/4: AI Analysis
  ✓ Approved
? Create package.json and install dependencies? Yes
  ✓ Scaffolded with pnpm

▸ Phase 4/4: Building Documentation
  ✓ Generated 12 docs
  ✓ Created AGENTS.md

Configuration

Environment Variables

Auto-Updates

ClaudeTools checks for updates automatically and prompts to upgrade when a new version is available. Disable with:

# Per-command
claudetools onboard --no-update

# Permanently
export CLAUDETOOLS_NO_UPDATE=1

Integration with Claude Code

ClaudeTools generates files specifically designed for Claude Code:

1. AGENTS.md — Placed in project root, automatically read by Claude Code
2. .claude/CLAUDE.md — Points to AGENTS.md, follows Claude Code conventions
3. Documentation structure — Organized for easy AI navigation

When you start a Claude Code session, it will automatically have context about:

• Your tech stack and dependencies
• Project structure and entry points
• Coding conventions and patterns
• Links to relevant documentation

Context7 Integration

ClaudeTools integrates with Context7 to fetch up-to-date documentation for your dependencies. When available, it will:

1. Resolve library names to Context7 IDs
2. Fetch official documentation, best practices, and examples
3. Generate markdown files in .claudetools/docs/libraries/

This requires mcp-cli to be configured with Context7 access.

Supported Technologies

Frameworks (25+)

Libraries (40+ categories)

Dev Tools

Troubleshooting

"Claude CLI not available"

The AI analysis features require Claude CLI. Install it from claude.ai/cli.

Without Claude CLI, ClaudeTools will:

• Still detect your stack automatically
• Skip AI-powered proposal generation
• Generate documentation based on detected dependencies

"No project files detected"

This message appears for empty directories. ClaudeTools now supports new project setup — just answer the questions and it will recommend and scaffold a stack for you.

Documentation not generating

Ensure you have:

1. mcp-cli installed and configured
2. Context7 MCP server accessible
3. Network connectivity

Use --verbose to see detailed output:

claudetools onboard --verbose

Refreshing stale documentation

If your dependencies have changed:

claudetools onboard --refresh

This will re-fetch all documentation and regenerate AGENTS.md.

Uninstalling

npm uninstall -g @claudetools/cli

To remove generated files from a project:

rm -rf AGENTS.md .claude .claudetools

Contributing

ClaudeTools is part of a monorepo. To contribute:

git clone https://github.com/claudetools/claudetools
cd claudetools
pnpm install
pnpm dev

Run tests:

pnpm test

License

MIT

Built for AI-assisted development. ClaudeTools reduces the friction of onboarding AI agents to your codebase by automatically generating comprehensive context files.