Get started in 5 minutes
Took is a local CLI. No account, no cloud, no API keys required for the free tier. Install, initialise, and you're coaching your first prompt. New to the loop? took start gives you a 60-second tour, and took chat opens an interactive session — natural language, no shell quoting.
Install in Claude Code
The Claude Code plugin installs Took's five hooks directly into your agent session — coaching prompts, guarding tool calls, reviewing diffs, protecting context budget, and metering each session's real cost when it ends.
Install in Codex CLI
The same coach runs in OpenAI's Codex CLI — the same five hook events and slash commands, packaged as a Codex-native plugin in the codex/ directory of the public repo. Clone first: Codex resolves Git-source marketplaces at the repo root, and the root hosts the Claude Code marketplace.
One-time hook trust. Installing does not activate hooks. On your next interactive codex session, Codex shows a “New hook — review required” prompt listing Took's hooks. Review and trust them once — this is Codex's designed security flow: you, not an installer, approve what runs on your machine.
Command table
Generated from took --help — grouped the way the CLI groups them. Run took <command> --help for flags.
| Command | Description | Tier |
|---|---|---|
| Start here | ||
took start | New here? A 60-second tour of the loop and the first commands to try. | free |
took init | Set up Took in this folder (.took/, config, AGENTS.md) — no account needed. | free |
took chat | Interactive Took session — natural language + /commands, no shell quoting. Running bare `took` opens it too. | free |
| Assess & right-size | ||
took prompt"<task>" | Right-size a task and coach the next RePPIT step. Returns a copy-ready prompt. | free |
took ready | Agent-readiness report card for this repo (scored 0–100) + the highest-leverage fix. | free |
took eval | Score this repo: fused Took Score + ranked improvements. Account required. | Pro |
took stats | Directional git-derived habit metrics: diff size, churn, test co-change. Alias: took trends. | free |
| Build & review | ||
took diff | Review the current change for scope, missing tests, secrets, and slop. | free |
took scan | Scan the repo for leaked secrets — and PHI/PII with --phi. | free |
took docs-check | Check README / .env.example / AGENTS.md for drift vs the current change. | free |
| Ship | ||
took pr-ready | Score the change for PR readiness: scope, tests, docs, secrets. | free |
took secure | Run the compliance Secure gate over the change, code-vs-org separated. The Pipp Health register (Max) folds it into the loop after Test. | free |
| Progress & coaching | ||
took xp | Your XP ledger — combined across every repo, segregated by repo. | free |
took cost | Your cost ledger — spend per task & type, context pressure, and honest attribution coverage. Local-only. | free |
took explain<action> | Explain an action in plain English — grounded, no fabricated citations. Pipp-depth (--deep) unlocks with Max. | free |
took pipp[level] | Switch coaching register: pipp | health | off. The Pipp and Pipp Health registers are Max features. | Max |
| Account | ||
took login | Connect this workspace to your Took account — optional, local-first by default. took logout clears the token. | free |
took sync | Push XP + directional metric snapshots to your account. Derived data only — never code. | free |
| Agent integration | ||
took guard | Inspect a tool call for dangerous ops / secrets before it runs. | free |
took hook | Agent hook protocol: read event JSON on stdin, emit a decision. Drives the Claude Code + Codex plugins. | free |
took install-hooks | Install git (pre-commit/pre-push) and/or Claude Code hooks. | free |
took statusline | Render a one-line Claude Code status line: prompt right-sizing + XP. | free |
took badge | Print a shields.io endpoint JSON for an Agent-Ready README badge. | free |
| More | ||
took recall<query> | Recall the most relevant symbols for a query — zero-dep structural map, budget-fit context slices. | free |
took cartridge | Repo memory cartridge: compress repo knowledge into a slim, source-grounded, frozen artifact. Faithfulness-gated. | free |
took task | Git-native task graph: add / ready / show / claim / close / list. Powers cost-per-task attribution via commit trailers. | free |
took learn | Your learning analytics — corrections, right-sizing, and waste per week, from your own event log. Local-only. | free |
took upgrade | Upgrade your plan from the terminal — pays via Stripe Checkout, then unlocks paid features. | free |
Tier notes. took eval needs Pro in the engineer register and Max in the Pipp registers. The Pipp and Pipp Health registers (took pipp / took pipp health) and Pipp-depth explanations (took explain --deep) need Max. Everything else runs free, locally, with no account.
Hook architecture
Took operates through hooks — intercepting key events in the agent lifecycle to coach, guard, review, and meter without replacing the agent itself. The same hook protocol drives Claude Code and Codex CLI.
UserPromptSubmitPreToolUsePostToolUsePreCompactStopPre-CommitPre-PushSecure gateModes
Regulated workflow setup
Pipp Health is included in Took Max. Switch to the health register with took pipp health — PHI scanning turns on, guarding goes strict, and the Secure phase activates after Test. You can also run the gate standalone anytime with took secure.
Disclaimer: Pipp Health assesses and surfaces compliance signals. It does not certify compliance with HIPAA, SOC 2, HITRUST, or any other framework. It is not a substitute for qualified legal counsel or a security auditor. Learn more →