Skip to main content

Changelog

Version history for the @ethosagent/cli and its workspace packages. The current version lives in the VERSION file at the repo root. Entries are newest first.

Source​

Entries are seeded from the commit log on main. For the canonical machine-readable view, run git log --oneline in the repo, or browse the GitHub commit history.

Conventions​

  • Date · ISO-8601 (YYYY-MM-DD).
  • Status · alpha (interfaces may break without notice), beta (stable interfaces, evolving features), stable (semantic-version contract).
  • Highlights · Three lines, one per headline feature.
  • Notable changes · One bullet per material change.
  • Breaking · One bullet per breaking change, or "None".
VersionDateStatus
0.4.152026-06-09beta
0.2.72026-05-11beta
0.2.62026-04-28beta
0.2.52026-04-10beta

0.4.15​

Date · 2026-06-09 Status · beta

  • Mandatory feature gaps — nine cross-cutting capabilities (plugin commands, inline context, zero mode, admin panel, remote gateway, data sources, background notifications, environment-gated skills, skill evolver) land in a single release.
  • Plugin extensibility reaches parity with built-in features — slash commands, data sources, and widget templates all surface through the same registries and RPCs that core uses.
  • Zero mode (ethos -z) makes the agent composable in shell pipelines, CI, and git hooks without an interactive session.

Notable changes

  • Gap 3 — Plugin slash commands. Plugins register slash commands via api.registerSlashCommand() that work across all surfaces (CLI, web, gateway, Telegram, Discord, Slack). Listed in /help with a [plugin] tag. Tab-completable in CLI.
  • Gap 4 — Inline context references (@ref). @file and @url tokens in user messages are resolved and inlined before the LLM sees the prompt. Files truncated at 8,000 chars. Tab-completable in CLI, file picker in web composer.
  • Gap 5 — Zero mode. ethos -z "prompt" runs a single prompt non-interactively, streams to stdout, exits. Composable with --personality, --model, --session, piped stdin.
  • Gap 7 — Web admin panel. Admin RPC endpoints for managing MCP servers and system configuration. Gated by adminEnabled config flag. Admin URL printed on ethos serve startup.
  • Gap 8 — Desktop remote gateway. Desktop app can connect to an Ethos server on another machine. CORS accepts file:// and RFC 1918 private IP origins for Electron and LAN deployments.
  • Gap 9 — Plugin data sources with widget templates. Plugins register read-only SQLite databases via api.registerDataSource() and declare widget templates in widgets.yaml. Widget template cards create pre-filled dashboard panels on click.
  • Gap 10 — Background job notifications. Offline notification buffer in the gateway delivers process_complete notifications on the user's next turn when they were disconnected during job completion.
  • Gap 11 — Environment-gated skills. Skills can declare environment requirements. includeUnavailable parameter added to the skills list RPC so the library can show gated skills with availability status.
  • Gap 12 — Skill evolver wiring. End-to-end wiring of @ethosagent/skill-evolver: analyzes eval JSONL output, proposes skill rewrites and new skills, human approval queue in web and desktop UI, ethos evolve CLI command.

Breaking

  • None.

Versions 0.2.8 -- 0.4.14 shipped incremental improvements including the web dashboard, desktop app, dashboard system, and design-token engine. Detailed entries for these versions are forthcoming.

0.2.7​

Date · 2026-05-11 Status · beta

  • Docs rewrite under the /docs skill (originally shipped as DOCS.md at the repo root) — two-persona shell ("Using Ethos" / "Building on Ethos"), Diátaxis four-pillar within each.
  • Kanban tool for personalities that need to coordinate multi-step plans without leaning on the prompt.
  • Theming and skin engine — per-user skins pinned in ~/.ethos/config.yaml, single @ethosagent/design-tokens source of truth across TUI and Web.

Notable changes

  • Authored the 18-page "Using Ethos" tree (~4,100 lines) covering quickstart, tutorials, how-tos, reference, and explanation.
  • Added the todo tool for the agent's own task-tracking; enforces a single in_progress task at a time (MULTIPLE_IN_PROGRESS error code).
  • Shipped a 10-skill coding skill bundle plus the Skills docs hub.
  • Split the observability library from the Ethos vocabulary so non-Ethos surfaces can reuse the storage and retention machinery.
  • Added a security-controls catalogue and addressed the pre-launch audience boundary gaps surfaced during the safety chapters.
  • Pinned pnpm and tightened the safety-scanner's pre-install scan; gated empty mcp_servers blocks from passthrough.
  • Switched the agent dev workflow to script-first CI with lefthook hooks and PR templates.
  • Telegram gateway no longer crashes on a bad bot token — Bot.start rejections are caught and logged.
  • Skin override propagates correctly from CLI personality setup and from the Web UI.

Breaking

  • None at the public CLI surface. The internal Skin token shape under @ethosagent/design-tokens evolved; consumers should re-pin the workspace version.

0.2.6​

Date · 2026-04-28 Status · beta

  • In-process safety watcher and InjectionClassifier wired into the production AgentLoop.
  • Universal always-deny filesystem floor with symlink-defeat for ScopedStorage.
  • SSRF defenses — scheme allowlist, per-personality net policy, redirect revalidation, policy-fingerprinted session reuse.

Notable changes

  • Added the approvalMode capability gate and an expanded hardline blocklist.
  • Default-deny non-http(s) URLs in the browser route.
  • Split policyFingerprint from the session map key so a forged key alone cannot bypass policy.
  • Verified session.policyFingerprint instead of trusting the map; strict policy-keyed lookup everywhere.
  • Documented the approvalMode capability gate as no-op-by-design today; the contract is locked.
  • Worktree hook plus hard check on the agent-sandbox parent directory.

Breaking

  • Sessions persisted before 0.2.6 lack a policyFingerprint and will be ignored under the new lookup. /new to start a fresh session.

0.2.5​

Date · 2026-04-10 Status · beta

  • Observability — @ethosagent/observability-sqlite ships and is wired into the production AgentLoop.
  • Wave B retention — RetentionConfig, safety.observability config, nightly prune cron, support-bundle export.
  • Setup wizard — single-step re-entry, paste enabled on every token and key input, disabled-with-label state for unsupported providers.

Notable changes

  • ethos retention and ethos data CLI commands.
  • Support-bundle tar export and an inspect archive tier.
  • Wave A observability foundation: store turn-level token usage, latency, and tool-call durations.
  • storeToolArgs: 'full' redaction bypass for trusted operators.
  • Onboarding wizard parity with the TUI; arrow-key direction fix on the launch-chat prompt.
  • Storage abstraction completed in the data CLI surface; --personality is surfaced in the help output.
  • Tail cursor starvation fix in the observability reader.

Breaking

  • None.

Upgrade notes​

When moving between minor versions, follow this sequence:

  1. Read the relevant section above for any Breaking entry.
  2. Upgrade the CLI: npm install -g @ethosagent/cli@latest.
  3. Verify the new version: ethos --version.
  4. If the breaking notes call for a session reset, run /new in chat or remove ~/.ethos/sessions.db.
  5. If the breaking notes call for a config rewrite, run ethos setup — answers default to the existing values.

The patch stream (0.2.x → 0.2.y) does not change config schemas. Minor bumps (0.x → 0.y) may add fields with safe defaults; old configs continue to parse. Major bumps (0.x → 1.x, when they happen) will document migration steps inline above.

To check the current version programmatically:

cat /path/to/repo/VERSION
# or
ethos --version

See also​