Oboto VS

Multi-LLM AI coding assistant for VS Code with background agents, hierarchical memory, peer coordination, and a full tool ecosystem.

Features

Multi-Provider LLM Support

Oboto VS supports local and cloud LLM providers with a dual-model triage architecture — fast local models handle simple queries while powerful remote models tackle complex tasks.

Agent System

• Foreground agent — Interactive chat in the VS Code sidebar
• Background agents — Spawn parallel agents with agent/spawn for concurrent tasks, each with independent tool trees, budget ceilings, and timeouts
• Kuramoto sync monitor — Oscillator-based cross-agent synchronization detection; visual indicators show when agents converge on similar work
• Up to 50 concurrent agents (default: 5)

Tool Ecosystem

Hierarchical Memory

Three-tier durable memory powered by prime-resonance semantic encoding (tinyaleph):

• Conversation — Ephemeral, per-session; inherited by spawned agents
• Project — Per-workspace; persists across sessions
• Global — Cross-workspace; persists everywhere

Tool outputs are auto-captured at low strength. The LLM promotes noteworthy entries upward via memory/promote.

Surfaces & Routes

• Surfaces — AI-authored HTML pages rendered in VS Code webview panels. Stored in .obotovs/surfaces/. Can use CDN libraries (React, Tailwind, etc.) and call local API routes.
• Routes — Local API endpoints following Next.js App Router conventions. Stored in .obotovs/routes/. Supports dynamic segments ([id]), hot-reloads on file change.

Project Management

Built-in project management that supports three modes:

• New builds — Scaffold a project, plan features, track tasks, and review code
• Existing codebases — Auto-detect conventions (tech stack, naming, test patterns, linting) and enforce them going forward
• Ad-hoc — Lightweight task tracking without upfront planning

Projects are stored in .obotovs/projects/<name>/ with JSON files for plans, tasks, and reviews. Key capabilities:

Active project conventions and plan progress are automatically injected into the agent's system prompt, ensuring consistent adherence to established patterns.

Workspace Skills

Drop markdown files in .obotovs/skills/ with optional YAML frontmatter (name, description, when). The agent discovers and applies them automatically.

Peer Coordination

Multiple VS Code windows running Oboto VS on the same workspace discover each other via HTTP heartbeats. Agents can dispatch tasks to peers (with user approval) and ask questions across windows.

Permission Modes

Installation

From VSIX

npm run build
npm run package
code --install-extension obotovs-0.1.1.vsix

Development

npm install
cd webview-ui && npm install && cd ..
npm run dev

Press F5 in VS Code to launch the Extension Development Host.

Configuration

All settings are under obotovs.* in VS Code settings. Key options:

{
  // LLM providers
  "obotovs.localProvider": "ollama",
  "obotovs.localModel": "llama3:8b",
  "obotovs.remoteProvider": "anthropic",
  "obotovs.remoteModel": "claude-sonnet-4-20250514",

  // Agent limits
  "obotovs.maxConcurrentAgents": 5,
  "obotovs.defaultAgentBudgetUsd": 0.5,
  "obotovs.agentTimeoutMs": 300000,

  // Behavior
  "obotovs.permissionMode": "prompt",
  "obotovs.triageEnabled": true,
  "obotovs.maxIterations": 50,
  "obotovs.maxContextTokens": 128000,
  "obotovs.autoCompact": true,

  // Features
  "obotovs.surfacesAutoOpen": false,
  "obotovs.uiControlEnabled": false,
  "obotovs.peerDispatchEnabled": true,
  "obotovs.instructionFile": "CLAUDE.md"
}

API keys are read from environment variables or can be entered via the settings UI:

Project Instructions

Place a CLAUDE.md file in your workspace root (or any parent directory) to provide project-specific context to the agent. The filename is configurable via obotovs.instructionFile.

Architecture

src/
  agent/
    orchestrator.ts      # Central coordinator
    agent-manager.ts     # Foreground + background agent lifecycle
    agent-host.ts        # ObotoAgent wrapper; emits UI-neutral events
    webview-bridge.ts    # Per-agent event relay to React UI
    session-store.ts     # Session persistence (per-window)
    system-prompt.ts     # Dynamic prompt builder
    tool-tree.ts         # Swiss-Army-Tool tree registration
    memory/              # Hierarchical memory (encoding, fields, manager)
    sync/                # Kuramoto cross-agent sync monitor
  config/
    settings.ts          # VS Code settings → typed config
    provider-registry.ts # LLM provider metadata
  projects/              # Project management (plans, tasks, reviews, conventions)
  surfaces/              # AI-authored HTML panel manager
  routes/                # Local API endpoint manager
  skills/                # Workspace skill discovery
  peers/                 # Multi-window coordination (HTTP RPC)
  vscode-integration/
    sidebar-provider.ts  # WebviewView provider
  shared/
    message-types.ts     # Extension <-> webview protocol
    logger.ts            # Structured logging

webview-ui/src/
  App.tsx                # Main React app
  components/
    ChatPanel.tsx        # Conversation display
    InputArea.tsx        # User input with slash commands
    AgentStrip.tsx       # Background agent pills with sync dots
    PeersStrip.tsx       # Peer window indicators
    ObjectManagerView.tsx # Memory/surface/route object browser
  hooks/
    useMessages.ts       # React state management
    useVsCode.ts         # VS Code API bridge

Commands

Testing

npm test

Runs vitest suites for the memory system, sync monitor, and project management.

License

MIT — Sebastian Schepis