Skip to main content

Opinionated coding agent harness

AI companion for focused coding.

Tailored for developers who want to stay in the flow. Elph understands your repository context, calls tools natively, and asks before risky actions.

Pre-alpha. Breaking changes and bugs are expected.
Read the release notes before you upgrade.

$ curl -fsSL https://elph.space/install.sh | bash
cargo install --locked elph / source Rust ≥ 1.97 · Linux & macOS
elph / current repository build

$ elph

usermake provider setup less noisy

elphreading instructions and narrowing files

toolfocused tests queued before full validation

Work queue

  • Inspect config pathdone
  • Patch provider flowready
  • Run package testsnext

Less setup

Project instructions, prompts, and runtime defaults load from the working context.

More throughput

The turn loop is built around focused edits, native tools, and test-first validation.

Clear control

Risky shell and file actions stay visible through explicit approval paths.

Extensible core

Providers, tools, prompt templates, and skills grow without bloating the daily path.

Workflow

Start with work, not settings.

Elph is intentionally small on the surface. Enough structure to move fast, with the important decisions still visible.

  1. 01

    Open a repository

    Run Elph where the code lives so it can load nearby instructions, current files, and project context.

  2. 02

    Describe the outcome

    Ask for the end state. Elph inspects, searches, edits, tracks todos, and keeps changes scoped.

  3. 03

    Approve and verify

    Review tool actions, apply the change, and run focused tests before broader validation.

Capabilities

Minimal does not mean fixed.

Focused TUI

Streaming transcript, markdown, keyboard-first controls, mouse support, paste handling, and session logs. elph

Native tool loop

Read, write, edit, AST grep, PTY via shell_use, web fetch, todos, and skills — not a chat wrapper.

Provider routing

OpenAI, Anthropic, Gemini, xAI, OpenRouter, Copilot, Bedrock, Groq, DeepSeek, or a local OpenAI-compatible endpoint. Switch mid-session.

Approval workflow

Plan vs Build. Risky actions are gated. Approved plans land in .elph/plans/ before the full tool surface returns.

Local project memory

Floppy memories with FTS + vectors in .elph/store.db. Lessons stay on disk for later turns.

Extension points

MCP (stdio + HTTP), wasmi WASM extensions, SKILL.md, ACP for editors, headless elph run, and worktrees.

Install

Run it locally.

Prebuilt binaries, or cargo. First launch scaffolds ~/.config/elph/ and a project .elph/. Pre-alpha: breaking changes and bugs are expected — read the release notes before you upgrade.

$ curl -fsSL https://elph.space/install.sh | bash

cargo install --locked elph · releases