How tool output is handled
Everest decodes recognized JSON tool-result wrappers before compression, including wrappers following a tool execution metadata prefix. Escaped newlines become actual lines so the compressor can select valid line ranges. Execution metadata and the surrounding result structure are preserved. When compression fails, Everest returns the original output and remembers the failure in a bounded, process-local cache. Later requests containing the same failed content and compression configuration skip compression, even if the task goal or command changes. Changed content or compression configuration, a process restart, or eviction from the cache makes the content eligible for another attempt. Compression requests carry a request ID and a content hash through the CLI, API, and model service so failures can be correlated across service telemetry. The content hash is the first 16 hexadecimal characters of the SHA-256 digest of the decoded content sent for compression.Get started
Requires macOS or Linux, Bash or Zsh, and a workingcodex command.
Install and complete browser login:
https://install.everestagi.com
and configures it to use the hosted Everest API at
https://api.everestagi.com/v1. The same installation command applies when
starting from this repository. No local model server, GPU, or Modal deployment
is required.
The final source command makes everest available in the current shell.
The installer uses a random anonymous onboarding ID to measure completion from
installer download through first compression. Everest records only funnel stage,
time, and CLI version for this flow. It does not attach terminal commands, prompts,
tool output, credentials, or IP addresses to the onboarding funnel.
Open a new terminal, then start Codex:
~/.codex/config.toml.
Useful commands
Start a run without compression:40/42 requests included, when usage is incomplete. Cost totals and percentages use recorded
usage for models with known list prices; models without known prices are
excluded and noted in the output. If no response usage was recorded, the card
shows only the observed token savings and, for one known model, its list-price
value, without percentages. Codex versions that support a shared background
daemon are launched in local-process mode so the run’s provider and response
usage remain attached to that run. If a terminal response omits usage, Everest
can reconcile it from per-response Codex usage records written during the same
launch. It does not use cumulative turn or thread totals.
--details shows token accounting and pricing assumptions. For machine-readable output:
usage_responses, responses, and usage_complete for usage
coverage, plus priced_models, unknown_models, and cost_complete for cost
coverage.
Check connection problems:
everest update to update immediately, or set
EVEREST_AUTO_UPDATE=0 to disable automatic updates. Updating preserves your
configuration, credentials, shell integration, and savings history.
If everest is not found, open a new terminal. Existing installations older than
0.2.12 must run the installer once before automatic updates are available. They
can preserve their existing login without starting a new browser flow:
Uninstall
Remove Everest but keep your saved configuration, credentials and savings history:everest update or an automatic update, run everest install and
reload the shell file it prints to activate the updated wrapper before uninstalling.
If your terminal still has a wrapper loaded from an older Everest installation,
clear it once without restarting the terminal: