Package Exports

@nocodeveloper/zoe-cli
@nocodeveloper/zoe-cli/dist/cli/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@nocodeveloper/zoe-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Zoe CLI

Zero config, maximum power. Zoe is an AI-powered coding assistant that manages everything in the backend.

Quick Start

# 1. Install
npm install -g @zoe/cli

# 2. Login with GitHub
zoe login

# 3. Start coding!
zoe chat

That's it! No API keys, no configuration files, no environment variables. Zoe handles everything through InsForge.

Features

Zero Configuration - Just login and start working
GitHub OAuth - Secure authentication via InsForge
AI Gateway - Powered by OpenRouter through InsForge
Project Intelligence - Automatic project scanning and analysis
Interactive TUI - Beautiful terminal interface with streaming
Slash Commands - Quick access to common operations
Tool System - File reading, writing, editing, searching, and shell commands
Session Persistence - Conversation history saved automatically

Commands

Command	Description
`zoe login`	Login with GitHub (opens browser)
`zoe logout`	Logout and clear session
`zoe whoami`	Show current logged in user
`zoe models`	List available AI models
`zoe use <model>`	Select a model to use
`zoe chat`	Start interactive chat
`zoe run "task"`	Execute a specific task
`zoe scan`	Scan project structure
`zoe doctor`	Analyze project health
`zoe summary`	Show project summary

How It Works

1. Install

npm install -g @zoe/cli

zoe login

This opens your browser for GitHub OAuth authentication. Zoe stores your session securely.

3. Choose a Model (Optional)

zoe models                    # See available models
zoe use deepseek/deepseek-v4-pro  # Select a model

4. Start Coding

zoe chat                      # Interactive mode
zoe run "Add authentication"  # Task mode

Project Intelligence

Zoe automatically scans your project to understand its structure:

zoe scan      # Manual scan
zoe doctor    # Check for issues
zoe summary   # View project overview

The scan results are saved in .zoe/project-intelligence.json and used by the AI to provide better assistance.

Slash Commands

During chat, use these commands:

Command	Description
`/model`	Switch to a different model
`/new`	Start a fresh conversation
`/help`	List available commands
`/session`	Show session info and token usage
`/export`	Save conversation as Markdown
`/scan`	Scan project structure

Configuration

Zoe stores configuration in .zoe/config.json:

{
  "model": "deepseek/deepseek-v4-pro",
  "maxSteps": 100,
  "maxCost": 10,
  "autoScan": true,
  "display": {
    "inputStyle": "block",
    "toolDisplay": "grouped",
    "loader": {
      "text": "Thinking",
      "style": "spinner"
    }
  }
}

Environment Variables

Zoe manages all configuration through InsForge. Users never need to set environment variables.

For development, you can set:

# InsForge (managed by Zoe)
INSFORGE_URL=https://your-app.insforge.app
INSFORGE_ANON_KEY=your-anon-key

# OpenRouter (managed by Zoe)
OPENROUTER_API_KEY=your-api-key

# Zoe defaults
DEFAULT_MODEL=deepseek/deepseek-v4-pro
ZOE_MAX_STEPS=100
ZOE_MAX_COST=10
ZOE_AUTO_SCAN=true

Architecture

zoe-cli/
├── src/
│   ├── cli/
│   │   ├── index.ts          # Main entry point
│   │   └── commands/
│   │       ├── login.ts      # GitHub OAuth
│   │       ├── chat.ts       # Interactive TUI
│   │       └── ...           # Other commands
│   ├── core/
│   │   ├── agent.ts          # OpenRouter agent
│   │   ├── config.ts         # Configuration
│   │   ├── insforge.ts       # InsForge client
│   │   ├── intelligence.ts   # Project scanning
│   │   └── session.ts        # Session persistence
│   ├── tools/
│   │   ├── index.ts          # Tool registry
│   │   ├── file-read.ts      # Read files
│   │   ├── file-write.ts     # Write files
│   │   ├── file-edit.ts      # Edit files
│   │   ├── glob.ts           # Find files
│   │   ├── grep.ts           # Search content
│   │   ├── list-dir.ts       # List directories
│   │   └── shell.ts          # Execute commands
│   └── ui/
│       ├── banner.ts         # Zoe ASCII art
│       ├── renderer.ts       # Tool display
│       ├── loader.ts         # Loading animations
│       ├── input-styles.ts   # Input styles
│       ├── terminal-bg.ts    # Background detection
│       ├── commands.ts       # Slash commands
│       └── styles.ts         # ANSI styles
├── .zoe/                     # Project data
│   ├── config.json           # User configuration
│   ├── project-intelligence.json
│   └── sessions/             # Chat history
├── package.json
├── tsconfig.json
└── README.md

Dependencies

@openrouter/agent - AI agent framework
@insforge/sdk - InsForge SDK
commander - CLI framework
chalk - Terminal colors
glob - File matching
zod - Schema validation

Development

# Clone the repository
git clone https://github.com/your-username/zoe-cli.git
cd zoe-cli

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Type check
npm run typecheck

@nocodeveloper/zoe-cli