Elph

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

Warning

This actively developed project may have usability issues due to ongoing changes and occasional bugs.
Always check release notes before upgrading, since breaking changes could disrupt your workflow.

Quick Start

Releases are tagged as elph-v*. See GitHub Releases.

Installation

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

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

Pin a version or install the latest pre-release:

curl -fsSL https://elph.space/install.sh | bash -s -- --version 0.0.26
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

Development

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)

Contributing

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

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

Living implementation notes: openwiki/quickstart.md.

Attribution

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).
• code-review-graph by Tirth Kanani — elph codegraph integration (MIT).
• Grok Build by SpaceXAI — coding-agent system prompt (Apache 2.0).

See NOTICE.md for details and license texts.

License

This workspace uses a mixed license model:

• Application (elph) — Apache License 2.0 (LICENSE-APACHE)
• Libraries (elph-ai, elph-agent, elph-tui, elph-swarm) — 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.}