@thenoo/cli

CLI scaffolder for @thenoo/agentkit projects

Quickly scaffold production-ready AI agent projects with TypeScript, FinOps tracking, and IDE integration.

Quick Start • Templates • IDE Presets

🚀 Quick Start

# Using npx (recommended)
npx @thenoo/cli init my-agent

# Or install globally
npm install -g @thenoo/cli
noo init my-agent

✨ Features

• 🎯 Interactive CLI - Guided project setup with prompts
• 📦 Multiple Templates - Minimal, Dashboard, Serverless options
• 🔌 Adapter Support - OpenAI, Azure, or mock-only
• 💻 IDE Integration - Presets for Cursor, GitHub Copilot, VS Code
• 📘 TypeScript First - Full type safety out of the box
• 💰 FinOps Built-in - Budget tracking from day one
• ⚡ Fast Setup - Working agent in under 2 minutes

📖 Usage

Basic Command

npx @thenoo/cli init [name] [options]

Interactive Mode

npx @thenoo/cli init

You'll be prompted for:

• Project name
• LLM adapter (OpenAI, Azure, or none)
• Template type (minimal, dashboard, serverless)
• IDE preset (Cursor, Copilot, VS Code, or none)

Command Options

| Option | Description | Default | |--------|-------------|---------| | --adapter <type> | LLM adapter: openai\|azure\|none | none | | --template <type> | Project template: minimal\|dashboard\|serverless | minimal | | --ide <type> | IDE preset: cursor\|copilot\|vscode\|none | none | | --typescript | Use TypeScript | true | | --skip-git | Skip git initialization | false | | --skip-install | Skip npm install | false |

Examples

Minimal agent with OpenAI:

npx @thenoo/cli init my-agent --adapter openai --template minimal

Dashboard with Cursor preset:

npx @thenoo/cli init dashboard-agent --template dashboard --ide cursor

Serverless with Azure:

npx @thenoo/cli init edge-agent --template serverless --adapter azure --ide copilot

Non-interactive:

npx @thenoo/cli init my-agent \\
  --adapter openai \\
  --template minimal \\
  --ide cursor \\
  --typescript \\
  --skip-install

📦 Templates

Minimal

Basic agent setup with tools and FinOps tracking.

Generated Structure:

my-agent/
├── src/
│   └── index.ts          # Main agent file
├── package.json
├── tsconfig.json
├── .gitignore
└── .github/
    └── workflows/
        └── ci.yml

Features:

• Single agent file
• Calculator tool example
• Budget manager
• Event listeners

Dashboard

Agent with Express server and real-time monitoring.

Features:

• Express server
• Real-time metrics endpoint
• Web UI scaffold
• CORS support

Serverless

Edge-ready serverless function with agent.

Features:

• Vercel/Cloudflare compatible
• Streaming responses
• Budget controls
• Environment-based config

💻 IDE Presets

Cursor

• .cursorrules with agent development context
• VS Code settings for TypeScript

GitHub Copilot

• .github/copilot-instructions.md with coding guidelines
• Tool creation patterns
• FinOps best practices

VS Code

• .vscode/settings.json - Editor configuration
• .vscode/extensions.json - Recommended extensions
• .vscode/launch.json - Debug configuration

🔌 Adapter Support

OpenAI

Includes:

• @thenoo/adapter-openai dependency
• OpenAI adapter setup with withFinOps()
• Environment variable configuration
• Budget policies

Environment:

OPENAI_API_KEY=your_api_key

Azure OpenAI

Includes:

• @thenoo/adapter-azure dependency
• Azure adapter setup
• Deployment configuration

Environment:

AZURE_OPENAI_KEY=your_key
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com

None (Mock Only)

Perfect for:

• Local development
• Testing
• CI/CD pipelines
• No API key required

📁 Generated Project

package.json

Includes:

• @thenoo/agentkit - Core agent framework
• @thenoo/finops - Budget management
• zod - Schema validation
• Adapter (if selected)
• TypeScript tooling (if enabled)

src/index.ts

Includes:

• Agent creation with createAgent()
• Budget manager setup
• Tool definitions with Zod schemas
• Event listeners
• Adapter integration (if selected)

README.md

Includes:

• Getting started guide
• Environment variable setup
• Project structure
• Links to documentation

.github/workflows/ci.yml

Includes:

• Dependency installation
• Type checking (for TS projects)
• Agent execution
• Environment secrets

🧪 Development

Running Tests

cd packages/cli
pnpm install
pnpm test

Building

pnpm build

Local Testing

# Link globally
pnpm link --global

# Test the CLI
noo init test-project

📊 Requirements

• Node.js ≥18
• npm, pnpm, or yarn

🤝 Related Packages

• @thenoo/agentkit - Core agent framework
• @thenoo/finops - FinOps cost tracking
• @thenoo/adapter-openai - OpenAI integration
• @thenoo/adapter-azure - Azure OpenAI integration

📚 Learn More

• GitHub Repository
• @thenoo/agentkit Documentation
• Examples

🐛 Issues

Report bugs and feature requests on GitHub Issues.

📄 License

MIT © Zachery Kuykendall