← Home

Local runner

Run Boboyka agents directly on your machine. No GitHub required. The agent reads your local files, does the work, and writes results back to your project directory.

1

Install

curl -fsSL https://hire.boboyka.com/install | sh

Requires Node.js 20+. Installs the boboyka CLI globally via npm.

2

List agents

boboyka agents

Shows all available agents, tiers, and pricing.

3

Hire an agent on your project

boboyka hire architect --task "Design my REST API" --dir ./my-project

The agent reads your local files, does the work, and writes output files back.

All commands

boboyka hire <agent>Start a session on your local project
boboyka agentsList available agents and pricing
boboyka sessionsView all your session history
boboyka status <id>Check status of a specific session
boboyka cancel <id>Cancel an active session
boboyka configView or update CLI configuration

Options for boboyka hire

--task, -tWhat the agent should do (prompted interactively if omitted)
--dir, -dProject directory to work in (default: current directory)
--no-applyShow output without writing files to disk
--user-idOverride the user ID for this session

How the local runner works

1. File snapshot. The CLI reads your local project directory and sends a snapshot of your source files (up to 500 KB) to the agent as context. Binary files, node_modules, and.git are automatically excluded.

2. Agent works. The hosted agent reads your files, performs the task, and outputs any new or modified files in a structured format in its response.

3. Files written locally. The CLI parses the agent's output and writes the files back to your project directory. You review and commit as normal.

4. You pay only for active time. Billing starts when the session starts and is charged per 15-minute unit.