Welcome to Bahulam

Bahulam Code is an AI coding agent that lives in your terminal and can also open a local browser workspace for code, documents, spreadsheets, images, and diagrams. It reads your workspace, plans changes, edits files, runs checks, and self-corrects on failure. Bring your own model - 40+ supported. Runs locally, calls LLMs through Bahulam Gateway for metering and credits.

New here? Start with Getting Started — install, sign in, and ship your first change. Already installed? Jump to Commands for the slash-command reference.

Install

npm i -g @bahulam/code

Then in any project directory:

bahulam login              # sign in via browser
bahulam                    # start an interactive session
bahulam workspace open .   # open the local browser workspace

Docs

Getting Started — install, sign in, run your first turn
Local Browser Workspace — Cloud IDE-style browser UI for local folders and documents
Commands — every /slash command and CLI subcommand
Attachments — inline files, images, PDFs, clipboard content
MCP — connect Model Context Protocol servers (stdio, SSE, WebSocket, HTTP)
Agents & Sub-Agents — built-in roles, user-defined YAML agents, delegation, traces
Choosing a Model — Sonnet vs Opus vs BYOK, tier limits
Approvals & Safety — risk tiers, permission modes, HITL
Remote Sessions — detach, attach from another terminal, control from a paired phone
Skills — install and use portable skill bundles
Automation & CI/CD — headless mode, local mode, CI integration
Getting Good Results — accuracy patterns, when to use /plan
Settings — the dashboard, credits, keys, defaults
Troubleshooting — common errors and fixes
Reference — env vars, keyboard shortcuts, files on disk

What’s live today

Package 0.1.7 · Gateway at gateway.bahulam.ai.

~40 slash commands — session, planning, status, git, model, attachments, agents, settings
Local browser workspace — bahulam workspace open, file tree, tabs, previews, chat, trace, uploads, approvals
MCP support — 4 transports (stdio, SSE, WebSocket, streamable HTTP)
Rich attachments — images (png/jpg/gif/webp), PDFs, docs (md, csv, json, yaml, html), clipboard/paste via @clipboard
HITL approvals — six permission modes, per-tool auto-approve policies, audit log
Local checkpoints — every write is undoable; /history undo rolls back to the last checkpoint
Session persistence — ~/.bahulam/conversations/{sessionId}.jsonl, resumable from any directory
Detachable sessions + remote control — bahulam daemonize, bahulam attach, pair a phone, approve from anywhere (Remote Sessions)
User-defined sub-agents + workflows — .bahulam/agents/*.yaml and .bahulam/workflows/*.yaml
Sub-agent orchestration — explore, plan, verify, debug, refactor, plus delegate and advise

Where things live on disk

Global (~/.bahulam/) — auth token, prompt history, hooks, session archives, checkpoints, BM25 index, local browser workspace state. Per-project (<cwd>/.bahulam/) — project policy, user-defined agents/workflows, task lists, mission reports, HITL approval log.

Full layout in Reference.

Getting Started