Edit code Find a bug, fix the function, and run it to verify the result.
The portable coding agent.
6.4 MB portable binary. Written in ANSI C and Lua. Runs on Linux, macOS, Windows, Haiku, and more. Auditable, MIT.
A small C core.
Lua on top.
Explore the architecture A coding agent should be a tool you can understand, carry with you, and change. psi starts with a small C core and puts the high-level behavior in Lua.
The agent loop, terminal interface, tools, and providers are all open to inspection. Keep the parts you need. Build the parts you’re missing.
- Anthropic
- OpenAI Codex
- OpenRouter
- Ollama
Choose your model.
Anthropic, OpenAI Codex, OpenRouter, or local models with Ollama. Resume a session with a different provider.
- Started a session
- Branched to try another approach
- Returned to the main branch
- Resumed with a different provider
Keep your context.
Branch a conversation, explore another approach, and return. Sessions are append-only JSONL with a full tree.
$ psi --agent "fix the failing test"$ psi --eval "1+1"2> psi --replWork your way.
An interactive TUI, a simple REPL, one-shot prompts, and Lua evaluation. At your keyboard or in your scripts.
Dependencies
Dependency map
Nix runtime closure + direct build inputs
- Target
.#default- Commit
- 646098f
- Build closure
- 918 packages
Other platforms and static builds differ. The diagram shows runtime relationships and direct build-input relationships.
Select a package to follow its connections.Expand a package for its license and dependencies.
Runtime7 direct
argtable3.3.1
Package license metadata: BSD-3-Clause
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
cjson1.7.19
Package license metadata: MIT
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
curl8.22.0
Package license metadata: curl
3 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
mbedtls3.6.7
Package license metadata: Apache-2.0, GPL-2.0-or-later
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
nss-cacert3.126
Package license metadata: MPL-2.0
glibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
libedit20260508-3.1
Package license metadata: BSD-3-Clause
2 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
ncurses6.6
Package license metadata: MIT
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
lua5.5.0
Package license metadata: MIT
2 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
ncurses6.6
Package license metadata: MIT
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
nss-cacert3.126
Package license metadata: MPL-2.0
Build-only inputs9 direct
bash5.3p15
Package license metadata: GPL-3.0-or-later
cjson1.7.19
Package license metadata: MIT
gcc-wrapper15.3.0
Package license metadata: GPL-3.0-or-later
gnumake4.4.1
Package license metadata: GPL-3.0-or-later
libedit20260508-3.1
Package license metadata: BSD-3-Clause
nss-cacert3.126
Package license metadata: MPL-2.0
pkg-config-wrapper0.29.2
Package license metadata: GPL-2.0-or-later
stdenv-linux26.05pre-git
Package license metadata: MIT
zlib1.3.2
Package license metadata: Zlib
Runtime7 direct
argtable3.3.1
Package license metadata: BSD-3-Clause
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
cjson1.7.19
Package license metadata: MIT
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
curl8.22.0
Package license metadata: curl
3 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
mbedtls3.6.7
Package license metadata: Apache-2.0, GPL-2.0-or-later
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
nss-cacert3.126
Package license metadata: MPL-2.0
glibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
libedit20260508-3.1
Package license metadata: BSD-3-Clause
2 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
ncurses6.6
Package license metadata: MIT
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
lua5.5.0
Package license metadata: MIT
2 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
ncurses6.6
Package license metadata: MIT
1 dependenciesglibc2.42-84
Package license metadata: LGPL-2.0-or-later
2 dependencieslibidn22.3.8
Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later
1 dependencieslibunistring1.4.2
Package license metadata: LGPL-3.0-or-later
xgcc15.3.0
Package license metadata: GPL-3.0-or-later
nss-cacert3.126
Package license metadata: MPL-2.0
Build-only inputs9 direct
bash5.3p15
Package license metadata: GPL-3.0-or-later
cjson1.7.19
Package license metadata: MIT
gcc-wrapper15.3.0
Package license metadata: GPL-3.0-or-later
gnumake4.4.1
Package license metadata: GPL-3.0-or-later
libedit20260508-3.1
Package license metadata: BSD-3-Clause
nss-cacert3.126
Package license metadata: MPL-2.0
pkg-config-wrapper0.29.2
Package license metadata: GPL-2.0-or-later
stdenv-linux26.05pre-git
Package license metadata: MIT
zlib1.3.2
Package license metadata: Zlib
Retained at runtimeBuild-time only
Portable by design
C89 and Lua are a deliberate choice. psi runs on familiar desktops and less-traveled systems, with a Cosmopolitan build that runs on Linux, macOS, and Windows.
Read the portability notesLinux
The maintained build target, built against system libraries via pkg-config.
Windows
Runs as a Cosmopolitan fat executable, with shell commands routed via cmd.exe.
Haiku
Runs in a Haiku VM, with helper scripts for the r1beta5 x86-64 setup.
macOS
Builds with Homebrew dependencies and runs through the Cosmopolitan build.
FreeBSD / OpenBSD
Builds with pkgconf and a native toolchain. Cosmopolitan runs on OpenBSD 7.3.
Tested across i686, x86_64, aarch64, and riscv64 where available. See the porting notes for build details.
Extend with Lua
Explore the extension APIAdd a slash command. Register a tool. Subscribe to the agent lifecycle. Your extensions are ordinary Lua files, loaded straight from disk.
Even the agent loop and terminal rendering live in Lua. Customization goes all the way down.
-- A command, in a few lines.
return function(psi)
psi.commands.register("greet", function(rest)
return psi.records.new_command_action(
"print", "hi, " .. (rest ~= "" and rest or "friend")
)
end)
endInstall psi
Bring a model provider and a project.
nix run github:siraben/psiRequires Nix with flakes enabled.
git clone https://github.com/siraben/psi.git
cd psi
nix develop
make
./build/psiNix supplies the build dependencies. See the README for details.