A coding agent run through a hub. The evener hub orchestrator serves the
web UI — Evener's default interactive surface — where you start sessions,
watch the agent read files, run commands, and edit code, and steer it with
follow-up messages. The hub tracks many concurrent sessions at once, and
evener tui gives the same hub a terminal dashboard. A non-interactive
command line handles scripting and automation.
New here? docs/getting-started.md walks from install to your first session.
Evener uses the LLM's native tool-calling and supports OpenAI, Anthropic,
Google, and other providers. For how the code is
organized, see docs/architecture.md. For the runtime
contracts that subagents, plugins, and hooks operate under, see
docs/subagent-runtime-contracts.md. For
background jobs, see docs/job-control.md. To confine a
session's file, process, and network access with --sandbox, see
docs/sandboxing.md. For how sessions are titled, see
docs/session-auto-naming.md. To build, test, and lint this repo,
see docs/developing-evener/README.md — or
run make help for every target with a one-line summary.
Install
Install the latest release on Linux x64 or macOS Apple silicon:
curl -fsSL https://raw.githubusercontent.com/prime-radiant-inc/evener/main/install.sh | sh
The installer verifies the release archive's SHA-256 checksum and installs
evener, evener hub, evener tui, evener doctor, and evener migrate
under ~/.local/share/evener/bin, symlinked into ~/.local/bin. Make sure
~/.local/bin is on your PATH.
From a source checkout:
make install
For tagged releases, snapshot builds, alternate prefixes, and a system-style
install under /usr/local, see
docs/getting-started.md. Verify any install
with evener --version.
Upgrade evener, evener hub, evener tui, and evener doctor with
evener upgrade. The command follows the binary's install channel: release
builds upgrade to the latest release, and snapshot builds upgrade to the latest
successful main build. Pass release, snapshot, or a tag such as v1.2.3
to switch tracks. evener migrate is not updated by evener upgrade; rerun
the installer, or run make install (or sudo make install-system), to refresh
it. The TUI and web UI expose the same mechanism through their /upgrade
command.
On first use, Evener creates:
${XDG_STATE_HOME:-$HOME/.local/state}/evener/runfor live daemon rendezvous files and per-daemon logs.${XDG_STATE_HOME:-$HOME/.local/state}/evener/auth-tokenfor the local hub/TUI bearer token.${XDG_STATE_HOME:-$HOME/.local/state}/evener/projects/<project-id>/for saved per-project session state. The project ID is readable (derived from the canonical project path) and ends with a 10-character base62 suffix.${XDG_CONFIG_HOME:-$HOME/.config}/evener/skillsfor standalone user skills, discovered automatically.${XDG_CONFIG_HOME:-$HOME/.config}/evener/pluginsfor user plugins.
No comments yet.