Tooling CLI

Tooling: CLI & binaries

The evener CLI is the engine: a non-interactive coding agent. You give it a prompt — as arguments or piped via stdin — and it runs a tool-calling loop against your repo until the work is complete, printing only the final result text on stdout. Progress goes to stderr: human-readable by default, or NDJSON events with --verbose (suitable for piping to jq).

(Source: README.md)

Build & install

make build        # the evener CLI
make install      # builds + installs evener, evener-hub, evener-tui, evener-doctor, evener-migrate

make install places binaries under ~/.local/share/evener/bin and symlinks them into ~/.local/bin. There is also a release installer:

curl -fsSL https://raw.githubusercontent.com/prime-radiant-inc/evener/main/install.sh | sh

evener upgrade upgrades installed binaries along the binary's install channel (release or main snapshot).

(Source: README.md)

Running a prompt

evener --model openai/gpt-5.2 "add input validation to the signup handler"
echo "refactor auth to use JWT" | evener --model anthropic/claude-opus-4-6

The model is provider-qualified in one value: --model <provider/model>. Providers: openai, anthropic, google, minimax, openrouter, openrouter-anthropic, kimi, glm, ollama. EVENER_MODEL supplies a default in the same format.

(Source: README.md)

Core flags

Flag	Description
--model <provider/model>	LLM model identifier (required unless resuming)
--dir <path>	Working directory (default: current directory)
--output-schema <json>	Inline JSON Schema replacing the default communicate.output schema
--verbose	Emit NDJSON events to stderr instead of human-readable progress
--resume <id> / --resume-last / --resume-with <id>	Resume a session / the latest session / start a new prompt carrying a previous session's context
--list-sessions	List saved sessions and exit

(Source: README.md)

Subcommands

From evener --help (cmd/evener/main.go):

Command	Purpose
evener serve	Run the evener HTTP/RPC server (the daemon the hub and TUI talk to)
evener launch-check	Validate the launch contract for a provider/model
evener openai	Manage OpenAI OAuth login (login, logout, status)
evener upgrade	Upgrade installed Evener binaries
evener plugin	Manage plugin marketplaces and plugins

(Source: cmd/evener/main.go, README.md)

Session persistence

Evener auto-saves session state under ${XDG_STATE_HOME:-~/.local/state}/evener/projects/<project-id>/sessions/ after each assistant turn, which is what makes --resume work. A repository's main checkout and its linked worktrees share one project bucket; a distinct clone gets its own.

(Source: README.md)

Sibling binaries

• evener-hub — multi-session web orchestrator. See Hub web UI & TUI.
• evener-tui — hub-backed terminal dashboard. See Hub web UI & TUI.
• evener-doctor — read-only forensic inspector. See evener-doctor.
• evener-migrate — one-time migration from the old Serf / interim ~/.evener layouts into the XDG config/state layout. Run it once before first launch if you have legacy data; --dry-run previews the moves.
• llmcall — minimal standalone one-shot LLM client (no agent loop, tool calls forbidden), built with make build-llmcall. Useful for throwaway calls, JSON/JSON-Schema output modes, and provider smoke tests.

(Sources: README.md)