Skip to content

Ellie CLI

Entelligence, in your terminal.

One binary that sits next to Claude Code, Codex, Cursor and Kiro. Ellie reviews your working copy, shows where your agent’s tokens went, and answers for incidents, security and your team’s docs. Your agent can run it too.

$ curl -fsSL https://cli.entelligence.ai/install.sh | sh
  • v0.1.60
  • Checksum verified
  • No sudo
  • Writes only under $HOME
  • Claude Code
  • Codex
  • Cursor
  • GitHub Copilot
  • OpenCode
  • Kiro
◆ ellie welcomespend █··········· $13.72 of $120
ellie · your agent, today
─ Afternoon, robin. ─Ellie, the Entelligence mascot4/6 set up /start
SPENDtoday$13.72 208 turnsof cap███··················· $120BIGGEST AVOIDABLETrim MCP schemas loaded at session startellie mcp status --unused● Waste classes now trace to the turn /whatsnew
◉‿◉ › █ ask anything, or / for commands
▸▸ ask ellie/agent welcome 0%↑↓ selectenter run/ commandsesc backctrl-d quit

Front ends

Three ways to run it, one set of commands.

A command never exists in one front end and not the others. Piped, every screen prints as one final frame.

Fullscreen: ellie

  • reviewthe working copy, before you push
  • incidentbrowse and remediate error incidents
  • securityscans, findings and suggested fixes
  • docsgenerated repo docs and gotchas
  • insights meyour spend, waste and coaching

◉‿◉ › /█arrows to move

A fixed frame you keep open. Type / for the command palette, and shift+tab to switch who answers.

Inline: ellie --inline

~/src/insights $ ellie --inline

◉‿◉ › review

◆ reviewed 0:41 · 3 files · found 3

● Day boundary computed in local time

● Unbounded fan-out to Slack

● Return shape changed without updating

◉‿◉ › /quit

~/src/insights $ █

Prints into your real scrollback and never takes over the terminal. Suited to tmux panes and narrow terminals.

Panel: ellie --panel

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8

4 budgetj/k to cycle

  • platform-infra42%
  • model-router81%
  • agent-insights115%

Number keys switch screens, with nothing to type. Made for a second monitor.

For agents

Your agent can run it too.

Everything Ellie prints, an agent can read. The binary also installs skills and an MCP server.

Pipe it

$ ellie incident show EKU-a3f82b1c --json | jq

{  "eku_id": "EKU-a3f82b1c",  "root_cause": "refresh skipped when    the token expires mid-request",  "recommended_fix": "retry once after    refreshing the token"}

Incident and security commands print --json, so an agent parses fields instead of scraping a table.

Skills it already knows

  • /entelligence-reviewReview a pull request or local diff with Entelligence
  • /incidentList patterns, trigger Fix Now, monitor the fix
  • /entloopFix review comments until the pull request is clean

Installed into the agent’s own skills folder, so Claude Code can call them by name.

Ask in plain English

◉‿◉ ›fix the worst payments incident this week

plan · 2 commands1 ellie incident list --json2 ellie incident fix EKU-a3f82b1c --repo acme/payments

enter approve esc cancel

/agent action turns a request into a plan of Ellie commands. You approve it before anything runs.

Where the tokens go

Where your agent’s tokens went, in five classes.

Your agents already keep session logs on disk. Ellie reads the last 28 days of them and sorts the avoidable spend into five classes, each with the skill that removes it.

18¢

of every dollar spent on AI coding tools becomes shipped product. The other 82¢ goes to rework and maintenance.

Token Maxxing Report
Entelligence Research · May 2026 · 1M+ pull requests

Avoidable spend by class

% of avoidable spend · 100 cells

  • Compaction churn29%
  • Retry and re-edit24%
  • Interrupted turns20%
  • Duplicate reads14%
  • Tool schema load13%
Two MCP servers loaded 31k tokens of tool schema the agent never called.ellie skills install lean-context

A sample week. Avoidable is an upper bound: each event priced at the context it carried, capped at what the session cost. See yours with ellie insights me.

Review

Every finding comes with a fix prompt.

4 in 5 review comments are never acted on, across 225,000+ in the Token Maxxing Report. Ellie reviews the working copy before you push and hands each finding to your agent.

Review the working copy

$ ellie review · 3 files changed

  • Msession/attribution.ts+12-4
  • Mdigest/slack.ts+31-2
  • Apolicy/limits.ts+58

findings3 found · 0:41

Staged and unstaged changes by default. A clean working copy falls back to the branch against its base.

Read it at the line

CRITICALattribution.ts:74

  1. 72export function startOfDay(d) {
  2. 73 // started_at is a UTC column
  3. 74 return new Date(d.getFullYear(),
  4. 75}
+ return new Date(Date.UTC(
+   d.getUTCFullYear(), …));

The evidence, the code at the line, and the suggested change, checked against your team’s review guidelines.

Hand it to your agent

$ ellie review --prompt-only

In src/session/attribution.ts, line 74: the day boundary is computed in local time and compared in UTC. Normalise to UTC first. Make only this change.

Claude Code applies the change1 file

With --prompt-only, each finding prints as a prompt your agent can run. In the app, c copies it.

Beyond review

Incidents, security and docs, from the terminal.

The rest of Entelligence answers in the same terminal. Incident and security commands take --json, so your agent can read them too.

Fix an incident

$ ellie incident list

  • JWT refresh skipped on expiry412×
  • Retry storm on charge webhook97×
  • Null region in usage export31×
  1. fix
  2. →track
  3. →monitor

ellie incident show gives the root cause and the recommended fix. Fix Now opens the pull request.

Scan for security issues

$ ellie security summary · acme/backend

82security score41 issues · 6 categories

  • critical2
  • high5
  • medium11
  • low23
  • SAST
  • IaC
  • SECRETS
  • SCA
  • CONTAINER
  • AUTH

The suggest command returns the exact code change for a finding, and issues gives the file and line your agent should edit.

Docs your agent reads first

$ ellie docs index

  • 12Billing and the charge path[gotchas]
  • 18Session attribution[learnings: 3]
  • 24Router tiers and budgets
  • 31Auth and token refresh[gotchas]

$ ellie docs get 12 --section "Retries"

Pages marked gotchas list mistakes the team already fixed. Pull them all to disk with ellie docs pull.

Review memory

Past findings reach the agent as it reads.

When Claude Code, Codex or Cursor reads a file with review history, Ellie adds the earlier finding to the agent’s next turn. Nothing blocks a tool.

  • Matched on the exact fileThe finding attaches to a read of a file a past review flagged, in the same repo or its worktrees.
  • Three a session at mostOnce per pattern. No network call and no model call on the read path.
  • Rated by the agentEach finding ends in a feedback line, so the ones that help stay and noisy ones drop.
  • Opt in, and in pilotTurn it on with ellie hooks review-guidance, and off with ellie hooks remove review-guidance.

claude code · sample session

>Fix the daily rollup. Sessions near midnight land on the wrong day.

● Read src/session/attribution.ts188 lines

Past review finding · PR #2606 · line 741 of 3

Day boundary computed in local time, compared in UTC. startOfDay() uses the runtime zone; started_at is UTC. Build the boundary with Date.UTC.

ellie rule feedback adv-2291 useful --acted-on yes

●An earlier review caught this same bug in PR #2606. I’ll build the boundary in UTC, as it suggests.

● Update src/session/attribution.ts+2 -1

Integrations

One install wires Ellie into your agents.

Ellie finds the coding agents on your machine and writes its MCP server, hooks and skills into each one’s own config. Running ellie hooks remove takes any of it back out.

Claude CodeMCP server, session hooks and skills~/.claude.json · ~/.claude/settings.json
CodexSession hooks and model routing$CODEX_HOME/config.toml · hooks.json
CursorMCP server and review hooks~/.cursor/mcp.json
KiroMCP server, steering file, hooks and skills~/.kiro/settings/mcp.json · steering/
GitHub CopilotModel routing, and sessions read for insightsnone
OpenCodeSessions read for insights, read onlynone

An MCP server for team context

context_for_filesContext for the files the agent has in hand
context_for_intentContext for what the agent plans to do

The entelligence-context server answers from the Entelligence World Model. Install it with ellie mcp install.

Called before the agent edits

claude code · sample session

>Add idempotency keys to the charge retry path.

entelligence-context · context_for_filesbilling/retry.ts, billing/charge.ts

● Read billing/charge.ts

The agent asks for the team’s context on the files it is about to change, then reads what that context points to.

Install

One binary for macOS, Linux and Windows.

The installer checks the published sha256 before it installs anything, never asks for sudo, and writes only under $HOME.

  • Five buildsdarwin-arm64, darwin-x64, linux-x64, linux-arm64, windows-x64
  • Static on LinuxLinked against musl, so there is no glibc floor.
  • Updates between sessionsApplied on the next launch, never mid-session. ellie update --rollback restores the previous binary.
  1. 1Install

    macOS, Linux$ curl -fsSL https://cli.entelligence.ai/install.sh | sh
    Windows$ irm https://cli.entelligence.ai/install.ps1 | iex
  2. 2Sign inthe only step that opens a browser

    $ ellie auth login
  3. 3Wire your agents

    $ ellie mcp install
  4. 4Review your working copy

    $ ellie review

Questions before you install.

  • Ellie works next to the agent you already use: Claude Code, Codex, Cursor, Kiro, GitHub Copilot or OpenCode. It reviews the working copy, reads your sessions for spend and waste, and wires routing and team context into the agents that support them.

  • Yes. Run ellie auth login once; it is the only step that opens a browser. Review, insights and incident data come from your organisation’s Entelligence workspace.

  • From your own sessions, sorted into five classes. The figure is an upper bound, not a bill: each avoidable event is priced at the context it carried, and the total is capped at what the session really cost. Read it as a ranking of what to fix first.

  • Yes. Incident and security commands print JSON, ellie review --prompt-only prints each finding as a prompt, and ellie mcp install gives Claude Code, Cursor and Kiro an MCP server for team context.

  • Only what a command you ran or a hook you installed sends: the diff under review, computed session data on sync, review memory events, and an hourly heartbeat. Raw transcripts stay local unless your organisation turns transcript upload on.

  • Run ellie hooks remove with the hook’s name, or ellie hooks status to see what is installed. Removal holds across updates and sign-ins.

Install Ellie, then open it next to your agent.

Install Ellie, run ellie auth login, then ellie review in any repo with changes.

  • macOS, Linux and Windows
  • No sudo, writes only under $HOME
  • No training on customer code