azkal-cli

AI-powered project scaffolder. Describe your project in plain English and get a complete, production-ready codebase in seconds.

Why azkal-cli?

Existing scaffolders like create-react-app or create-t3-app require you to already know your stack. azkal-cli lets you describe what you're building, and AI picks the optimal stack, generates the folder structure, configs, boilerplate, and documentation for you.

$ npx azkal-cli "I need a SaaS with auth, payments, and a dashboard"

That's it. A complete project scaffold, ready to go.

Quick Start

# Set your Anthropic API key
export ANTHROPIC_API_KEY=your-key-here

# Interactive mode
npx azkal-cli

# One-liner mode
npx azkal-cli "build me a REST API with auth and PostgreSQL"

Get your API key at console.anthropic.com.

Features

• 7 framework stacks — Next.js, Express, Vite+React, Vue, SvelteKit, Astro, Fastify
• Smart stack selection — AI picks the best tools if you don't specify
• Generation preview — see file tree and project plan before writing, confirm with y/n
• Auto-retry — retries up to 3 times on malformed AI responses
• Dependency validation — scans all imports and auto-adds missing packages
• Path traversal protection — generated files can't escape the output directory
• CSS cleanup — strips broken @apply directives from Tailwind output
• Dry run mode — preview what would be generated without writing files
• Init command — add missing configs (.gitignore, tsconfig, LICENSE, .editorconfig) to existing projects
• Persistent config — save your API key locally with azkal config

Commands

Generate a project

azkal                                    # Interactive mode
azkal "my project idea"                  # One-liner mode
azkal "blog platform" --stack sveltekit  # Force a specific stack
azkal "my app" --dry-run                 # Preview without writing
azkal "my app" --yes                     # Skip confirmation prompt
azkal "my app" -o ./projects             # Custom output directory

Init existing project

cd my-existing-project
azkal init

Scans your package.json, detects the framework, and adds any missing config files.

Manage API key

azkal config --key sk-ant-...   # Save API key
azkal config --show             # Show saved key (masked)

List stacks

azkal stacks

Supported Stacks

| Stack | Description | |-------|-------------| | nextjs | Next.js App Router + Tailwind + TypeScript | | express | Express.js REST API + TypeScript | | vite-react | Vite + React + Tailwind + TypeScript | | vue | Vue 3 + Vite + TypeScript | | sveltekit | SvelteKit + TypeScript | | astro | Astro + TypeScript | | fastify | Fastify REST API + TypeScript |

How It Works

1. You describe your project in natural language
2. Claude AI analyzes your description and picks the optimal stack
3. You preview the project plan (name, stack, file tree) and confirm
4. azkal-cli generates a complete project with validated dependencies
5. You cd in, npm install, and start building

Development

git clone https://github.com/Ialkyyyy/azkal-cli.git
cd azkal-cli
npm install
npm run build
npm test        # Run 15 tests
node dist/index.js "test project"

Contributing

Contributions are welcome! Feel free to open issues or submit PRs.

1. Fork the repo
2. Create your feature branch (git checkout -b feature/cool-thing)
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

License

MIT — Built with care by Alkhabaz-Dev