Elph

Rust workspace for AI agent applications — coding agent CLI, shared runtime libraries, and terminal UI components.

Releases are tagged as v* (stable) and v*-canary (canary pre-releases). See GitHub Releases.

Pre-built binaries (Linux, macOS, and Windows — x86_64 and arm64):

• Linux / macOS:

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

• Windows (x86_64):

  powershell -ExecutionPolicy Bypass -c "irm https://elph.space/install.ps1 | iex"

Pin a version (Linux / macOS):

curl -fsSL https://elph.space/install.sh | bash -s -- --version 0.0.26

Install the latest pre-release (Linux / macOS):

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

From crates.io (requires Rust >= 1.97):

cargo install --locked elph

From source:

cargo install --path elph

Requires Rust >= 1.97. Clone the repo, run make prepare, then make help for targets.

git clone https://github.com/riipandi/elph.git
cd elph
make prepare
make check && make test && make lint

Publish crates: make publish (see make help)

We welcome contributions to make Elph even better!

• Read our Contributing Guidelines for detailed guidelines
• Fork the repository and create a feature branch
• Submit a pull request with a clear title and description
• Join the discussion on GitHub Issues

Join the flow. Amplify your AI-powered workflow with Elph! 🚀

Documentation lives in docs/. Start with docs/README.md.

Elph re-implements concepts from several open-source projects in Rust:

• pi by Mario Zechner — architectural design, provider abstraction, tool system (MIT).
• OpenAI Codex CLI — Agent workflow inspiration: exit summary, goals, subagent orchestration (Apache 2.0).
• memelord by Glauber Costa — floppy memory module port (MIT).
• Grok Build by SpaceXAI — coding-agent system prompt (Apache 2.0).

See NOTICE.md for details and license texts.

This workspace uses a mixed license model:

• Application (elph) — Apache License 2.0 (LICENSE-APACHE)
• Libraries (elph-ai, elph-agent, elph-tui) — MIT License (LICENSE-MIT)

Third-party attributions and upstream license requirements are listed in NOTICE.md.

_{🤫 Psst! If you like my work you can support me via GitHub sponsors.}