bobbi-agent

Local Bobbi Agent CLI daemon — syncs Sprint Planner with ./.bobbi/ for AI IDEs like Cursor.

Install

npm install bobbi-agent

Or globally:

npm install -g bobbi-agent

Usage

CLI

bobbi start      # Start the sync daemon
bobbi login      # Authenticate with Sprint Planner (device code)
bobbi hooks      # Install git hooks (post-commit, post-checkout)
bobbi status     # Show connection status
bobbi stop       # Stop the daemon

Programmatic API

import {
  loadConfig,
  loadState,
  getValidAccessToken,
  startSyncEngine,
  stopSyncEngine,
  runForeground,
  spawnDaemon,
} from "bobbi-agent";
import type { Sprint, BobbiConfig, BobbiState } from "bobbi-agent";

Configuration

Create .bobbi/config.json in your project (or run bobbi login to set it up):

{
  "api_url": "https://your-sprint-planner.com",
  "project_id": "your-project-id"
}

Optional env vars:

• BOBBI_API_URL — Override API URL

Requirements

• Node.js >= 18
• Git repository

License

MIT