psi
A small, MIT-licensed coding agent you carry as one binary and change in Lua.
✓ Verified against psicode.ai · Nov 17, 2026Open sourceLinux · Mac · Windows · Command line

What it does
psi is an AI tool for coding from the terminal, explaining code and running AI models locally. It is open source and free to use.
The compiled part is kept small: a single 6.4 MB binary written in C, with the agent loop, the terminal interface, the tools and the model providers implemented in Lua, so the behaviour a user might want to change can be read and edited. The source is published under the MIT license and the tool is free to use. Installing it requires Nix with flakes enabled, and a model provider has to be set up before the first agent turn. Providers offered are Anthropic, OpenAI Codex, OpenRouter and local models through Ollama. Work can happen in an interactive TUI, a simple REPL, a one-shot prompt from a script, or a Lua evaluation. Sessions are stored as append-only JSONL files arranged as a tree, so a conversation can be branched to try a different approach and later resumed with another provider. Extensions are plain Lua files loaded from disk, and they can add slash commands, register tools or hook into the agent lifecycle. Linux is the maintained build target. Windows builds run as a Cosmopolitan fat executable, macOS builds use Homebrew dependencies, and there are separate notes for Haiku and the BSDs, with builds tested across i686, x86_64, aarch64 and riscv64 where those are available.
- Single 6.4 MB portable binary
- C core with Lua agent loop and tools
- Interactive TUI, REPL and one-shot prompt modes
- Anthropic, OpenAI Codex, OpenRouter and Ollama providers
- Append-only JSONL sessions kept as a tree
- Lua extensions loaded from disk
- Builds for Linux, macOS, Windows, Haiku and BSDs
- Dependency map and SBOM view
Verified facts
Each row links to the page we checked it on.| Open-source license | MIT | psicode.ai | ✓ Nov 17, 2026 |
|---|---|---|---|
| Platforms | Linux, macOS and Windows | psicode.ai | ✓ Nov 17, 2026 |
| Pricing | Free and open source | psicode.ai | ✓ Nov 17, 2026 |
What you can do with it
Good at
- Free and open source under the MIT license
- Small binary that runs on several desktop and hobbyist systems
- Agent loop, tools and interface can be modified in Lua
- Sessions can branch and resume with a different provider
Watch out for
- Installation requires Nix with flakes enabled
- A model provider must be configured before the first turn
Common questions
- What is psi used for?
- psi is used for coding from the terminal, explaining code, running AI models locally, writing code with AI and finding and fixing bugs. On AIToolMaps it ranks #3 of 11 for coding from the terminal.
- Is psi free?
- Yes. psi is open source and free to use.
- What platforms does psi run on?
- psi runs on Linux, Mac, Windows and Command line.
- Does psi have an API?
- Yes. psi offers an API, so developers can use it from their own code.
- What are the best alternatives to psi?
- The closest alternatives are Cursor, GitHub Copilot and Amazon Q Developer, which do most of the same jobs. Cursor is the closest one with a free plan.
Reviews
No reviews yetListing history
- Nov 17, 2026Checked against psicode.ai
- Nov 8, 2026Listed