Id CLI reference

Agent product: id (named after Sigmund Freud’s Id — the drive toward what is immediate and sufficient). Binary: Id (capital I — avoids coreutils id). Keys: idl_…. Repo: manishthatte/id. Narrative guide: Id documentation.

Install

curl -fsSL https://www.idlidu.dev/install.sh | bash
source ~/.config/Id/shellenv
Id health

# with a prepaid key:
curl -fsSL https://www.idlidu.dev/install.sh | ID_API_KEY=idl_… bash

# from source (dev):
git clone https://github.com/manishthatte/id.git
cd Id && pnpm install && pnpm install:Id

Artifacts: Id.mjs · tarball · install page

Env

export ID_API_KEY=idl_…
export ID_GATEWAY=https://gateway.idlidu.dev   # optional
export ID_API=https://api.idlidu.dev           # optional
# or: ~/.config/Id/env  (file wins over shell for ID_*)

Full list: Reference.

Commands

Id health | models | status | update
Id ask|plan|run|debug "…" --budget 0.10 --yolo
Id -p "…"                         # headless agent (no auto-approve)
Id --explore "map packages" run "…"
Id best-of-n "…" --best-of-n 3
Id sessions | resume <sessionId>
Id skills list|search|install …
Id import-rules                   # Cursor / Claude → .id/rules
Id soft-cap                       # local monthly soft cap
Id pr-fix [--watch]              # needs gh
Id handoff "…"                    # queue cloud long-run
Id serve [--acp]                  # embeds / ACP
Id metrics | login-help

Common flags

Id run "…" \
  --budget 0.25 \
  --model bottom \
  --effort high \
  --permissions yolo \
  --shell-net \
  --no-telemetry \
  --force

Flag	Effect
`--budget`	Turn USD cap (else key default)
`--model`	`bottom` or catalog id
`--effort`	Hint for Bottom escalation
`--permissions`	`manual` … `yolo`
`-p` / `--print`	Headless; tools still need approval policy
`--yolo`	Shortcut for permissive auto-approve
`--shell-net`	Allow shell network
`--no-telemetry`	Opt out of consented flush
`--force`	Bypass local soft monthly cap

REPL

Bare Id opens the interactive REPL: /ask /plan /agent /debug /budget /model /permissions /steer /status /help /exit.

VSCodium

Package packages/vscodium in the id repo — SecretStorage for idl_, side panel, spawns local Id.

Id guide · Agent API · Quickstart · Docs hub