files + shellWorks in your repository
Reads, searches and edits files in this directory and runs commands there.
champrep brings Mail, Calendar, Drive, Work, Chat and every CHAMPREP service to your terminal, with an AI agent that reads, edits and runs code in your project, always asking first.
$ curl -fsSL https://cli.champrep.com/install.sh | sh
CHAMPREP AI · billing-api · model auto · mode ask
› partial refunds are off by a cent. find the bug and fix it
● local_grep "roundCents" in src/** 12 matches
● local_read src/refunds/total.go 88 lines
Each refund line is rounded before the lines are summed, so
three rounded lines can drift by a cent from the true total.
● local_edit_file src/refunds/total.go +6 −3
Allow this edit? Yes · No · Always for src/**
› Yes
● local_bash go test ./src/refunds/... ok 0.84s
✓ Fixed: totals are summed in cents and rounded once.
1 file changed · tests pass · /diff to review · /rewind to undo
›model auto · mode ask · Shift+Tab to change · / for commands01 — AI AGENT
Run champrep ai in any directory. It reads, searches and changes files there and runs commands, and every edit and command asks first unless you allow it.
files + shellReads, searches and edits files in this directory and runs commands there.
/rewind /undoCheckpoints before every change. Review with /diff, roll back with /rewind.
--continueReopen the last conversation here, or any one with --resume.
/modelAuto picks one for you; bring your own key with champrep ai models.
/agents /tasksHand work to custom agents and follow long tasks while you keep going.
--worktreeRun a session in a fresh git worktree so your branch stays untouched.
/mcpConnect local MCP servers and use them next to the built-in tools.
/security-reviewAsk for a security review of the changes on your branch.
› /
/modelChoose the model for this session/planPlan first; nothing changes until you agree/diffReview every change the agent made/rewindReturn the files to an earlier checkpoint/undoUndo the last change/resumeReopen an earlier conversation/agentsRun or manage custom agents/tasksBackground tasks and their progress/worktreeContinue in a separate git worktree/mcpConnected MCP servers and their tools/permissionsRules for what may run without asking/security-reviewSecurity review of your branch/usageTokens and limits used so far/doctorCheck the installation and connection↑↓ to choose · Enter to run · /help lists every command
# Ask once and print the answer$ champrep ai -p "why does the invoice total drift on refunds?"# Machine-readable events for scripts$ champrep ai -p "list the go files here and count them" --output json# Let it fix a test, with only these tools$ champrep ai -p "fix the failing test" \
--allowed-tools "local_edit_file(src/**),local_bash(go test*)"# Pipe a prompt in$ git diff | champrep ai -p ---permission-mode or --allowed-tools say otherwise, and they never stop to ask.askThe default. Every file edit and command waits for your yes.accept-editsEdits inside the project go ahead; commands still ask.planRead-only. The agent explores and proposes a plan first.02 — EVERY SERVICE
Sixteen services behind one sign-in. Read your day, send mail, move files and file tickets without leaving the terminal.
champrep --help lists them all
Read threads and send mail, with the body inline, from a file or from stdin.
$ champrep mail threads$ champrep mail send --to [email protected] --subject "Report" --body @report.mdYour day and week at a glance, and new events in one line.
$ champrep calendar today$ champrep calendar weekCopy files both ways, list folders and check your storage.
$ champrep drive cp ~/report.pdf /reports/$ champrep drive quotaBoards and tickets from CHAMPREP Work, by id or key.
$ champrep work tickets$ champrep work ticket ENG-7One-shot answers, file summaries and the full agent.
$ champrep ai chat$ champrep ai summarize notes.mdSearch every service at once, or ask in plain language.
$ champrep search "q3 roadmap"$ champrep search "what did we decide about pricing" --aiList rooms, read recent messages and post to a room.
$ champrep chat ls$ champrep chat readCreate, read and edit your notes as plain text.
$ champrep notes ls$ champrep notes createList, read and issue invoices and send them to customers.
$ champrep invoice ls$ champrep invoice issuecontactscoursesmeetformssheetschartsbusinessbillingaccount
03 — SCRIPTS AND CI
Every command speaks --json. An API token stored once runs unattended jobs, and the same agent answers headlessly in CHAMPREP Code pipelines.
# JSON output for scripts and jqchamprep work tickets --json > tickets.json# Mail the nightly report from stdincat report.md | champrep mail send \
--to [email protected] --subject "Nightly" --body -# Back up a folder to Drivechamprep drive cp ./backups/db.tar.gz /backups/# Run one command against testchamprep calendar today --env testrelease-notes:
stage: deploy
rules:
- if: $CI_COMMIT_TAG
script:
- curl -fsSL https://cli.champrep.com/install.sh | sh
# CHAMPREP_TOKEN comes from a masked CI variable
- champrep ai -p "write release notes for $CI_COMMIT_TAG"
--output json > notes.json
- champrep mail send --to [email protected]
--subject "Released $CI_COMMIT_TAG" --body @notes.md
champrep auth tokenStore an API token once for CI, cron and scripts. Revoke it any time.
champrep keysCreate and manage keys for automation without opening a browser.
champrep webhooksSubscribe your own endpoints to events across the workspace.
--env testSwitch between production and test for one command or for good.
04 — SECURITY
Tokens live in your operating system's keychain, requests go through the CHAMPREP API gateway, and nothing secret is printed or sent to a model.
Sign-in and API tokens are stored in the operating system keychain, not in a dotfile.
champrep auth login uses your CHAMPREP account, with its two-factor and SSO rules.
auth status shows the active profile, rate limits and recent audit events.
Even --verbose wire logs redact the Authorization header.
Edits and commands need your yes unless a rule you wrote allows them.
Secret files are never read, and secrets in tool output are redacted before anything is sent.
Environmentproduction
Profile[email protected] (active)
Signed in withbrowser · SSO
Token storagemacOS Keychain
Rate limit4,812 of 5,000 left this hour
Recent events
09:12auth.login this machine
09:13drive.file.upload /reports/q3.pdf
09:20mail.send [email protected]
05 — INSTALL
One binary for macOS, Linux and Windows, on Intel and ARM. champrep upgrade keeps it current.
champrep auth loginOpens champrep.com in your browser. On servers and in CI, use champrep auth token instead.champrep calendar todayEvery service works the same way; champrep --help lists them.champrep aiRun it inside a project. Type / to see every command.champrep is for you at a terminal. To run CI/CD jobs on a machine, install champrep-code-runner from CHAMPREP Code.Install champrep, sign in with the CHAMPREP account you already have, and run your first command in under a minute.