CLI Commands

The Kodebase CLI (kb) provides commands for managing your development workflow.

Installation

# Using npx (always latest)
npx kodebase@latest

# Global installation
npm install -g kodebase

Commands

kb init

Initialize Kodebase in your project.

kb init

Creates a .kodebase/ directory with:

• config.yml - Project configuration
• artifacts/ - Directory for YAML artifacts

Options:

• --preset <name> - Use a configuration preset (solo, small_team, enterprise)

kb start

Start working on an issue.

kb start <issue_id>

Arguments:

• issue_id - The issue ID to start (e.g., A.1.1)

What it does:

1. Creates a branch named after the issue ID
2. Adds in_progress event to the artifact
3. Creates a draft PR with issue details
4. Pushes the branch to remote

Example:

kb start A.1.1
# Creates branch A.1.1, draft PR, copies context to clipboard

kb submit

Submit your work for review.

kb submit

What it does:

1. Validates implementation_notes exists (for issues)
2. Adds in_review event to the artifact
3. Marks the PR as ready for review

Validation:

• Issues require implementation_notes
• Milestones require delivery_summary
• Initiatives require impact_summary

kb status

Show current work status.

kb status

Displays:

• Current branch and associated artifact
• Ready issues
• In-progress work
• Completable artifacts

Configuration

Kodebase is configured via .kodebase/config.yml:

version: 1
preset: solo

settings:
  require_pr: false
  quality_gates:
    test:
      enabled: true
      command: "pnpm test"
    types:
      enabled: true
      command: "pnpm check-types"
    lint:
      enabled: true
      command: "pnpm lint"
    build:
      enabled: true
      command: "pnpm build"

Presets

• solo - Single developer, minimal ceremony
• small_team - Small team with basic PR workflow
• enterprise - Full governance and approval requirements