Skip to content

Termesh 0.1.0

Choose a tag to compare

View all tags
@iseif iseif released this 17 Aug 05:03
· 23 commits to main since this release
v0.1.0
2237b1c

First public release. The whole product ships at once because the parts only mean something
together: the agent is useful because it shares the buffers, the diagnostics, the diff, and the
terminal that the human is already looking at.

The agent loop

  • ACP client (Tier 1). Any agent speaking the Agent Client Protocol
    plugs in — Claude Code, Codex, Gemini CLI, OpenCode, Goose — configured as argv in
    ~/.config/termesh/agents.toml. No vendor is assumed or bundled.
  • Proposed edits arrive as reviewable inline diffs, marked in the gutter, accepted or rejected
    per hunk. Nothing reaches disk until you accept, a hunk you edited inside is flagged rather than
    overwritten, and one Ctrl+Z takes a whole proposal back.
  • The agent reads through the editor, so it sees unsaved buffers rather than stale disk.
  • Agent context carries what you see: bounded git branch and status with separately labelled
    staged and worktree diffs, live diagnostics, terminal output, and the same task catalog.
  • Command execution is permission-gated. The exact program, argv, cwd, and environment
    overrides are shown before anything runs. "Allow always" grants are exact and workspace-scoped;
    a command with environment overrides or a cwd outside the workspace is never persisted.
  • Tier 0 needs no integration at all — run any AI CLI in a terminal pane. With no agent
    configured the editor says so instead of assuming one.

The workspace

  • Editor on a transaction spine: every change is a versioned transaction, which is what makes
    human and agent edits safe to interleave. Undo groups a run of typing. Rust files are
    syntax-highlighted.
  • File explorer loading lazily, honouring .gitignore, and following changes on disk.
  • Terminals through managed PTYs — real interactive shells, scrollback while a command is still
    running, keyboard copy mode, and restartable exited tabs.
  • Search: Ctrl+P fuzzy file open and F9 workspace text search, using rg when present and
    falling back to native gitignore-aware implementations that a test pins against it.
  • Git on its own worker: status, branch, staged and worktree diffs, and explicit-index commits
    that never run an implicit add. Pull is fast-forward-only and push never forces.
  • Tasks through a language-neutral adapter — Cargo, package.json scripts with lockfile-aware
    runner selection, pytest, Maven/Gradle — plus exact commands from .termesh/workspace.toml.
    Failures become navigable Problems.
  • Language servers for Rust, TypeScript/JavaScript, Python, and Java, started lazily per
    document owner. Diagnostics, navigation, symbols, transaction-safe rename, quick fixes, and
    formatting. Servers are external programs; none is bundled or downloaded.
  • Crash recovery and session restore. Workspaces, buffers, the active tab, pane geometry, and
    terminal working directories come back. Recovered buffer content is offered, never applied
    behind you.
  • Layered configuration with an in-app diagnostic and a usable fallback for a malformed file —
    never a failed startup.

Known limitations

Read docs/support.md before relying on this. The boundaries that will affect
people most:

  • The macOS binaries are not signed or notarized. A browser download is quarantined and
    refused on first launch; clear it with xattr -d com.apple.quarantine ./termesh. Installing
    with cargo install, curl, or wget is unaffected.
  • Windows is best-effort, not Tier 1. Everything passes on Windows except pseudo-terminal
    teardown, which is unverified: closing a terminal can report a kill timeout (OS error 1460) and
    the exit event may not arrive. The three affected tests are marked #[ignore] on Windows rather
    than deleted, so a Windows host can reproduce it.
  • Tier 1 means language-server support, not highlighting. One tree-sitter grammar ships (Rust),
    so a TypeScript, Python, or Java file gets full language intelligence but renders as plain text.
  • An agent session does not survive restart. Transcript history is restored read-only and a
    fresh session starts; the implemented ACP baseline has no usable session-load path, and
    pretending replay was a resumed session would be unsafe.
  • A multi-file rename undoes per file, not as one atomic workspace-wide action.
  • Completion is explicitly invoked (Alt+/), not fired after every keystroke.
  • No debugger, plugin system, or multi-agent orchestration — those are post-beta platform work.
  • No terminal emulator has a recorded manual certification yet. A standards-compatible terminal
    Crossterm supports is expected to work, including over SSH.

Install

Prebuilt binaries for Linux (x86-64, AArch64), macOS (Intel, Apple Silicon), and Windows (x86-64)
are attached to this release, with SHA256SUMS. From source:

cargo install termesh --locked

Requires Rust 1.88 or newer.

Assets 8
Loading