NovaKit CLI

# Start the TUI (opens provider connect if not authenticated)
novakit

# With a specific model
novakit chat -m gpt-4o

# Resume a previous session
novakit -r <session-id>

# One-shot prompt
novakit chat -p "Explain this codebase"

# Login with API key
novakit auth login
novakit auth login --provider anthropic

# Check auth status
novakit auth status

# Logout
novakit auth logout
novakit auth logout --provider openai

# Start interactive chat
novakit chat

# Use specific model
novakit chat -m claude-sonnet-4-20250514

# Resume previous session
novakit chat -r <session-id>

# Set approval mode
novakit chat -a read-only    # Read-only mode (exploration only)
novakit chat -a auto         # Auto mode (default)
novakit chat -a full         # Full mode (auto-approve all)
novakit chat --yolo          # Alias for --approval-mode full

# Headless mode (for automation/scripts)
novakit chat -p "Fix the bug" --headless

# List configured providers
novakit provider list

# Show available presets
novakit provider presets

# Add provider from preset
novakit provider add anthropic --preset anthropic

# Add custom provider
novakit provider add my-provider \
  --endpoint https://api.example.com/v1 \
  --protocol openai \
  --model gpt-4

# Switch active provider
novakit provider use anthropic

# Remove provider
novakit provider remove openai

# List sessions
novakit session list
novakit session list --all

# Resume session
novakit session resume <session-id>

# Rename session
novakit session rename <session-id> "Feature Implementation"

# Compact session (reduce context)
novakit session compact <session-id>

# Export session
novakit session export <session-id> --format markdown
novakit session export <session-id> --format json

# Delete session
novakit session delete <session-id>

# Show all config
novakit config list

# Get specific value
novakit config get defaultModel

# Set value
novakit config set maxTokens 8192
novakit config set autoConfirmWrites true

# Initialize project config
novakit config init

# Show config paths
novakit config path

# Reset to defaults
novakit config reset

# Build vector index
novakit index build

# Check index status
novakit index status

# Search codebase
novakit index search "authentication logic"

# Check API quota/usage
novakit usage

# Run diagnostics
novakit doctor

# Start server for IDE extensions
novakit serve

# Check for updates
novakit update

{
  "defaultModel": "claude-sonnet-4-20250514",
  "maxTokens": 16384,
  "maxToolIterations": 10,
  "autoConfirmWrites": false,
  "showTokenUsage": true,
  "contextThreshold": 0.9,
  "autoCompactEnabled": true,
  "useVectorIndex": true,
  "maxContextChunks": 10,
  "maxContextTokens": 8000,
  "minContextScore": 0.15,
  "favoriteModels": ["gpt-4o", "claude-sonnet-4-20250514"],
  "disabledTools": [],
  "approvalMode": "auto"
}

novakit provider add ollama \
  --endpoint http://localhost:11434/v1 \
  --protocol openai \
  --model llama3.2

# Change via CLI
novakit chat -a read-only
novakit chat --yolo  # Alias for -a full

# Or press Tab to cycle modes during chat

# In chat
/spawn Run all tests and fix any failures
/spawn Generate API documentation

# Monitor
/tasks

# Kill a task
/task-kill <id>

# Project: My App

## Architecture
- React frontend with TypeScript
- Express backend with PostgreSQL

## Conventions
- Use functional components with hooks
- All API responses follow { data, error, meta } format

## Do NOT modify
- src/legacy/ (deprecated)

@docs/api-reference.md

# In chat, use # prefix
#project-context This is a React app using TypeScript...

# Or type # to open the memory picker

{
  "commands": [
    {
      "id": "review",
      "name": "Code Review",
      "description": "Review current file",
      "type": "prompt",
      "content": "Review this code for bugs and security issues:\n\n{{input}}"
    },
    {
      "id": "git-log",
      "name": "Git Log",
      "type": "bash",
      "content": "git log --oneline -10",
      "showOutput": true
    }
  ]
}

{
  "agents": [
    {
      "id": "reviewer",
      "name": "Code Reviewer",
      "icon": "🔍",
      "systemPrompt": "You are an expert code reviewer...",
      "model": "claude-sonnet-4-20250514",
      "includeContext": true
    }
  ]
}

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    }
  }
}

{
  "servers": [
    {
      "name": "typescript",
      "languages": [".ts", ".tsx", ".js", ".jsx"],
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "enabled": true
    }
  ],
  "autoDetect": true,
  "autoStart": true
}

# Large data files
*.csv
data/

# Sensitive files
.env*
secrets/

# Generated files
dist/
build/

novakit serve

# Opt out
novakit config set telemetryEnabled false

novakit doctor

novakit auth login --provider <provider-name>

/compact
# Or
novakit session compact <session-id>