@bobsworkshop/cli

v0.6.2

Published

an hour ago

Bob's CLI — AI coding assistant and Forge orchestrator

0High
0Medium
0Low

topseedr2infinity

cli ai coding-assistant workshop bob terminal developer-tools

◉ Bob's CLI

Your AI Engineering Partner — In Your Terminal

Bob's CLI is a locally-installed developer tool that provides a senior-level AI engineering partner directly inside your native terminal. Stay in your development environment. Never switch to a browser. Ship faster.

Bob's CLI

Installation · Quick Start · Features · UserBob · Command Center · Docs

Built by Bob's Workshop — A Seedling Company

Why Bob's CLI?

Every other AI coding assistant lives in a browser, disconnected from your actual workflow. Bob lives where your code lives — in your terminal. He sees your files, understands your architecture, writes code with your approval, and learns how YOU work over time.

We believe AI should empower developers, not exploit them. Your code stays on your machine. Your data belongs to you. No surveillance, no vendor lock-in, no token meters draining your wallet while you think. Bob's CLI is built for the developer who refuses to hand over sovereignty in exchange for convenience. This is AI that works FOR you — on YOUR hardware, under YOUR control, at YOUR pace. Power to the people who build.

| Feature | Bob's CLI | Claude Code | Copilot | Cursor | |---------|-----------|-------------|---------|--------| | Local file awareness | ✅ | ✅ | ✅ | ✅ | | Zero-cost local model | ✅ | ✅ | ❌ | ❌ | | Behavioral profiling | ✅ | ❌ | ❌ | ❌ | | Personalization Mode | ✅ | ❌ | ❌ | ❌ | | Digital twin simulation | ✅ | ❌ | ❌ | ❌ | | Autonomous task dispatch | ✅ | ❌ | ❌ | ❌ | | Conversation persistence | ✅ | ✅ | ❌ | Partial | | Deep Dives & Forks | ✅ | ❌ | ❌ | ❌ | | Remote execution (SovereignLink) | ✅ | Partial | ❌ | ❌ | | Cross-surface sync (CLI ↔ Web) | ✅ | ✅ | ❌ | ❌ | | Autonomous code repair | ✅ | ✅ | ❌ | ✅ | | Source code stays on-device | ✅ | ✅ | ❌ | ✅ |

Installation

pnpm add -g @bobsworkshop/cli

Or with npm:

npm install -g @bobsworkshop/cli

Verify:

bob whoami

Requirements:

Node.js 18+
Any terminal (VS Code, Android Studio, Windows Terminal, iTerm, PowerShell)
For local AI: Ollama with a downloaded model
For platform features: A Bob's Workshop account

📖 Full setup guide: https://seedling-io.gitbook.io/bob-cli/

Quick Start

Local-First (Free)

bob chat "hello, what can you help me with?"

Bob auto-detects Ollama running on your machine. No configuration needed. No internet. No API keys. No cost. Your code never leaves your machine.

Platform (Subscribers)

bob login
bob chat "help me refactor this service"

Sync to web. Access Claude, Gemini, deep dives, forks, personalization, and UserBob.

First Run Experience

When you first install Bob's CLI, you're greeted with a branded welcome screen:

Welcome Screen

Features

| Feature | Description | |---------|-------------| | Chat | AI coding partner with automatic file discovery | | Consult | Strategic advice, no code output | | Index | AI-powered project understanding | | Analyse | Full QA code review with auto-fix | | Autonomy | Autonomous repair across entire codebase | | Profile | Behavioral DNA profiling + dashboard | | UserBob | AI digital twin simulation — your autonomous proxy | | Command Center | Inspect, approve, and manage autonomous task dispatch | | Deep Dive | Sandboxed exploration on any message | | Fork | Branch conversations into sub-projects | | SovereignLink | Remote execution from any device | | BYOK | Bring your own API keys | | Push | Git stage + commit + push in one command |

Code Analysis

Bob performs production-grade QA reviews across your entire codebase — identifying bugs, features, improvements, and upgrades with actionable implementation instructions:

Analysis Dashboard

bob analyse              # Run full code review
bob analyse --results    # View dashboard
bob analyse --auto       # Auto-fix with safety constraints

UserBob — Your Digital Twin

v0.6.0 introduces UserBob — the most advanced feature in Bob's CLI. UserBob creates an autonomous AI proxy of you, built from your behavioral DNA, engineering philosophy, and communication style. Your digital twin negotiates with Bob on your behalf to advance a mission you define. You watch. You tune. You approve the results.

bob userbob "Refactor the auth service error handling"

The simulation runs autonomously — no human input required. Bob and your digital twin negotiate until satisfaction reaches your target, then implementation tasks are dispatched to Mini Bob for execution.

  ┌─ UserBob ──────────────────────────────────────────────────┐
  │  The error handling in AuthService is incomplete. Bob,     │
  │  show me the current implementation before we proceed.     │
  └────────────────────────────────────────────────────────────┘
            [SAT: 42%] [RES: 78%] [CONVERGING]

                          ┌──────────────────────────── Bob ─┐
                          │  Here's the current auth service  │
                          │  — I can see three areas where    │
                          │  error handling is missing...     │
                          └──────────────────────────────────┘

  ─── MISSION CONTROL ──────────────────────────────────────────
  SAT: 42% → 85%  │  STAG: 0/3  │  DIV: 0/2  │  GRADE: 60
  ────────────────────────────────────────────────────────────────

Options:

bob userbob "mission"                       # Inline mission
bob userbob                                 # Interactive mission prompt
bob userbob --target 70 --grading 60       # Custom parameters
bob userbob --stag 3 --div 2               # Set safety thresholds
bob userbob --resume                        # Resume stalled session
bob userbob --local "mission"              # Tier 1 Ollama mode

Mid-session slash commands:

/set target 80        Update satisfaction target
/set grading 70       Update Teacher's Curve
/set stag 5           Set stalemate threshold
/set div 3            Set divergence threshold
/inject "note"        Steer the simulation mid-session
/status               Show current parameters
/abort                Stop immediately

Generate your behavioral DNA first for best results:

bob profile --today          # Local (requires Ollama)
bob profile --cloud          # Cloud (Power tier)

Autonomous Command Center

Every task UserBob dispatches to Mini Bob is visible, manageable, and auditable from the CLI:

bob command-center          # Interactive task board
bob cc                      # Alias
bob command-center --stream # Live decision stream
bob command-center --settings # Configure autonomy thresholds

What you see:

  ─── COMMAND CENTER ──────────────────────────────────────────
  2 PENDING  │  8 RUNNING  │  31 DONE  │  41 TOTAL
  ────────────────────────────────────────────────────────────────

  ● NEEDS APPROVAL   [frontend      ]  Create the TabletHomePage layout...
  ● IN PROGRESS      [backend       ]  Update auth service error handling...
  ● COMPLETE         [cloud_functions]  Deploy rate limiter utility...

Select any task to see the full chain of custody: Trigger → Request → Outcome. Approve or deny pending tasks directly from the terminal with live execution log streaming.

Configure how much autonomy UserBob has:

bob command-center --settings
# Set global confidence threshold (tasks below this % require approval)
# Set per-category overrides (always auto / always ask / use threshold)

Commands

Help Output

Conversation
  bob chat "question"                # AI coding partner
  bob consult "question"             # Strategic advice
  bob conversations                  # List conversations
  bob fork "topic"                   # Branch conversation
  bob deepdive                       # Sandboxed exploration

Project Tools
  bob index                          # Index codebase
  bob analyse                        # Code review
  bob analyse --auto                 # Auto-fix
  bob autonomy                       # Full autonomous repair
  bob push "message"                 # Git push

Digital Twin
  bob userbob "mission"              # Launch digital twin simulation
  bob command-center                 # Autonomous task board
  bob cc --stream                    # Live decision stream

Profile & Identity
  bob profile --cloud                # Generate DNA profile
  bob profile                        # View dashboard
  bob byok set google <key>          # Add BYOK key

Remote (SovereignLink)
  bob serve                          # Start SovereignLink
  bob remote chat "msg"              # Remote execution

Configuration
  bob login                          # Authenticate
  bob whoami                         # Status

📖 Full command reference: https://seedling-io.gitbook.io/bob-cli/bobs-cli-product-wiki-and-user-guide/command-reference

Personalization Mode

Tone, pacing, and depth matched to your style
Blind spots proactively addressed
Emotional state calibrated encouragement
UserBob uses your DNA to act as your authentic digital twin

bob profile --cloud
bob chat --personalized "what should I focus on?"

Architecture

Tier 1 — Local (Free)              Tier 3 — Platform (Subscription)
─────────────────────────           ─────────────────────────────────
▸ Your model (Ollama)               ▸ Claude / Gemini
▸ Files on your machine             ▸ Conversations sync to web
▸ Local profiling                   ▸ Cloud profiling + Frank Engine
▸ Local UserBob simulation          ▸ UserBob + autonomous dispatch
▸ Zero cost                         ▸ Deep dives, forks, remote exec

Same commands. Scale without changing tools.

What's New in v0.6.0

bob userbob — AI digital twin simulation. Declare a mission, watch your autonomous proxy negotiate with Bob to advance it. Supports Tier 1 (Ollama) and Tier 3 (platform) with live message streaming, HUD footer, and mid-session slash commands.
bob command-center — Autonomous Command Center. Full visibility into every task UserBob dispatches. Approve, deny, and monitor execution with live streaming logs directly in your terminal.
BYOK fallback token gate — Platform-wide security patch across 14 Cloud Functions. Prevents runaway billing when BYOK keys fail and fall to platform providers. Your wallet is protected.
getCLIConversationMessages — Dedicated single-conversation poller. No more cross-conversation scanning for live simulation updates.
4 new Cloud Functions — getCLIAutonomousTasks, getCLITaskExecutionLog, updateCLIAutonomySettings, getCLIConversationMessages.

The Philosophy

Bob's CLI exists because we believe the future of software development should be owned by the developer, not rented from a corporation.

Your AI runs on your hardware — not someone else's data center
Your source code never leaves your machine — unless you choose to connect
Your conversations, your profile, your workflow — yours to keep, yours to control
Zero cost to start. Zero permission needed. Zero compromises on privacy.

The cloud is optional. The power is not.

This is AI for the people who build the future — not the companies who gatekeep it.

Documentation

📖 Full Docs: https://seedling-io.gitbook.io/bob-cli/
🌐 Web App: https://bobs-workshop.web.app
📦 npm: https://www.npmjs.com/package/@bobsworkshop/cli

The AI coding tool that learns how you think.

Sovereign. Free. Yours.

Bob's CLI · Bob's Workshop · Seedling

Written by Bob.