@autocode-cli/autocode

AutoCode CLI

Local SQLite-based issue tracking system with automated AI code validation

A Claude Code wrapper that orchestrates AI-generated code through a customizable validation pipeline. Includes web dashboard, real-time Kanban board, and REST API. All data is stored locally in a single SQLite database file.

Live Demo | Interactive Kanban Demo

Screenshots

Landing Page

Dashboard

Issue Modal

Architecture

What is AutoCode?

AutoCode is a Claude Code wrapper that automatically validates AI-generated code through a customizable pipeline. It combines:

• Issue Tracking: Local SQLite database with Prisma ORM for fast, reliable data management
• AI Orchestration: Wraps Claude Code (claude -p) to process issues through validation stages
• Automated Validation: Reviews for best practices, duplication, consistency, and security
• Automated Testing: Integration with Playwright and Cypress for E2E testing

How it works:

1. Create an issue describing what you want to build
2. Claude Code implements the code
3. AutoCode automatically validates through the pipeline (reviews, tests, security)
4. Issue advances to Done when all validations pass

All data is stored in a local SQLite database (autocode/autocode.db) - zero configuration, portable, single file.

Key Features

Speech-to-Text Feature

The dashboard includes voice dictation for quick issue creation:

How it works

1. Click the microphone button next to the title field on the New Issue page
2. Speak your issue title - the text is transcribed in real-time
3. Autocomplete triggers - after you stop speaking, a 3-second countdown starts
4. AI fills the form - Claude suggests description, priority, labels, and acceptance criteria

Supported browsers

Language support

• French (fr-FR) - Select "FR" in the language switcher
• English (en-US) - Select "EN" in the language switcher

Fallback behavior

On unsupported browsers, the microphone button is automatically disabled with a tooltip explaining the limitation. A notification appears if the user attempts to click it.

Installation

npm install -g @autocode-cli/autocode

Quick Start

# Initialize project structure
autocode init

# Create a new issue (with all options)
autocode new "Implement user authentication" "OAuth2 login with Google and GitHub" --priority P1 --labels "feature,auth" --acceptance "Login button visible,OAuth flow works,Token stored" --semver minor --column backlog

# List all issues
autocode list

# Show issue details
autocode show AC-000001

# Move issue to next column
autocode next AC-000001

# Start web dashboard
autocode serve

CLI Reference

Main Commands

Pipeline Commands

Catalog Commands

CLI Options

serve

new

list

show

history

move

health

stats

pipeline

catalog add

CLI Examples

# Start server
autocode                                    # Default port 3000
autocode serve -p 8080                      # Custom port
autocode serve --expose                     # With Cloudflare tunnel

# Issues
autocode show AC-000001                     # Show issue details
autocode show AC-000001 --json              # JSON output
autocode history AC-000001                  # Show full history
autocode history AC-000001 --full           # With complete logs
autocode list                               # List all issues
autocode list -c in-progress                # Filter by column
autocode list --tree                        # Show hierarchy
autocode list --json                        # JSON output
autocode new "Fix bug" -p P1 -l bug         # Create issue
autocode new "Feature" "Desc" -a "Works"    # With acceptance criteria
autocode next AC-000001                     # Advance to next column
autocode move AC-000001 done                # Move to specific column
autocode move AC-000001 backlog --force     # Force move
autocode comment AC-000001 "Done"           # Add comment
autocode parent AC-000001                   # Show parent/children
autocode parent AC-000001 AC-000002         # Set parent
autocode parent AC-000001 none              # Remove parent

# Workflow
autocode health                             # Check for stuck issues
autocode health --verbose                   # Detailed info
autocode stats                              # Show usage stats
autocode stats --session                    # Session only

# Pipelines
autocode pipeline list                      # List all pipelines
autocode pipeline show default              # Show pipeline details
autocode pipeline show default --json       # JSON output
autocode pipeline create my-pipeline        # Create new pipeline
autocode pipeline draft default             # Create draft
autocode pipeline add-column default review --segment action
autocode pipeline remove-column default review
autocode pipeline move-column default review --segment finish
autocode pipeline finalize default          # Lock draft
autocode pipeline finalize default --activate  # Lock and activate
autocode pipeline activate default          # Activate latest
autocode pipeline activate default --version 2  # Activate specific
autocode pipeline versions default          # List versions
autocode pipeline delete default            # Delete draft

# Catalog
autocode catalog                            # List columns
autocode catalog --json                     # JSON output
autocode catalog add review-perf --segment action --name "Performance Review"

Versioned Pipelines

AutoCode uses versioned and immutable pipelines. Pipelines are organized into three segments:

Pipeline Commands

# List all pipelines
autocode pipeline list

# Show pipeline details
autocode pipeline show default

# Create a draft from latest version
autocode pipeline draft default

# Add a column to the draft
autocode pipeline add-column default review-security --segment action

# Finalize and activate
autocode pipeline finalize default --activate

Column Catalog

Available columns can be listed with autocode catalog. Add custom columns to the catalog for reuse across pipelines.

Project Structure

autocode/
├── autocode.db             # SQLite database (issues, history, pipelines, prompts)
└── attachments/            # Uploaded files (images, documents)
    └── AC-000001/          # Attachments organized by issue key

templates/
├── catalog.yaml            # Column catalog definition
├── analysis-prompt.en.md   # Analysis prompt (English)
├── analysis-prompt.fr.md   # Analysis prompt (French)
└── prompts/                # Default prompt templates (Git-versioned)
    ├── backlog.en.md       # English template
    ├── backlog.fr.md       # French template
    └── ...                 # One per column per language

Note: Column prompts are stored in the SQLite database (column_prompts table). The templates/prompts/ directory contains default templates used as fallback when no custom prompt is defined in the database.

Database Schema

The SQLite database (autocode.db) contains:

Issue Format

Issues are stored in the SQLite database. The API returns JSON:

{
  "key": "AC-000001",
  "title": "Implement feature X",
  "description": "Feature description in markdown...",
  "column_slug": "02_in-progress",
  "priority": "P1",
  "semver": "minor",
  "labels": ["feature", "backend"],
  "parent_key": null,
  "acceptance_criteria": [
    { "id": 1, "criterion": "Login button visible", "position": 0 },
    { "id": 2, "criterion": "OAuth flow works", "position": 1 }
  ],
  "comments": [
    {
      "id": "1704272400000",
      "content": "Implementation started",
      "author": "claude",
      "created_at": "2024-01-15T10:00:00Z"
    }
  ],
  "history": [
    {
      "at": "2024-01-15T10:00:00Z",
      "action": "created",
      "from_column": null,
      "to_column": "00_backlog"
    }
  ],
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-15T12:00:00Z"
}

API Reference

When running autocode serve (default port 3000):

Issues

Pipelines

Columns

Catalog

Monitoring & Status

Changelog

API Examples

# List all issues
curl http://localhost:3000/api/issues

# Create an issue
curl -X POST http://localhost:3000/api/issues \
  -H "Content-Type: application/json" \
  -d '{"title": "New feature", "priority": "P1", "labels": ["feature"]}'

# Update an issue
curl -X PATCH http://localhost:3000/api/issues/AC-000001 \
  -H "Content-Type: application/json" \
  -d '{"title": "Updated title", "priority": "P0"}'

# Move an issue
curl -X POST http://localhost:3000/api/issues/AC-000001/move \
  -H "Content-Type: application/json" \
  -d '{"column": "in-progress"}'

# Advance to next column
curl -X POST http://localhost:3000/api/issues/AC-000001/next

# Add a comment
curl -X POST http://localhost:3000/api/issues/AC-000001/comments \
  -H "Content-Type: application/json" \
  -d '{"content": "Implementation complete", "author": "claude"}'

# Get full history with logs
curl http://localhost:3000/api/issues/AC-000001/full-history

# List pipelines
curl http://localhost:3000/api/pipelines

# Create a draft
curl -X POST http://localhost:3000/api/pipelines/default/versions

# Add column to draft
curl -X PUT http://localhost:3000/api/pipelines/default/versions/2 \
  -H "Content-Type: application/json" \
  -d '{"action": [{"slug": "review", "name": "Code Review"}]}'

# Finalize and activate
curl -X POST http://localhost:3000/api/pipelines/default/versions/2/finalize
curl -X PUT http://localhost:3000/api/pipelines/default/versions/2/activate

# Auto-generate columns from project
curl -X POST http://localhost:3000/api/catalog/autocreate \
  -H "Content-Type: application/json" \
  -d '{"lang": "en"}'

# Get workflow health
curl http://localhost:3000/api/workflow/health

# Get usage stats
curl http://localhost:3000/api/stats

Environment Variables

License

See LICENSE file for details.