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.

psi on Haiku, with a floating sakura window and red vertical Japanese text overlapping the terminal

Edit code Find a bug, fix the function, and run it to verify the result.

Live theme Change the running agent’s theme with a Lua extension.

Add a command Write a Lua extension, reload it, and use the new command.

Explore psi Follow a slash command through psi’s own source code.

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.

  1. Started a session
  2. Branched to try another approach
  3. Returned to the main branch
  4. 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.

Fix mean([]) in mean.pyclaude-opus-5-5 · low
$ psi --agent "fix the failing test"
$ psi --eval "1+1"2
> psi --repl

Work 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
Runtime SBOM Full build SBOM

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.

dependencies cluster_build Build-only inputs psi psi 0.2.0 argtable argtable 3.3.1 cjson cjson 1.7.19 curl curl 8.22.0 glibc glibc 2.42-84 libedit libedit 20260508-3.1 lua lua 5.5.0 nss-cacert nss-cacert 3.126 bash bash 5.3p15 cjson cjson 1.7.19 gcc-wrapper gcc-wrapper 15.3.0 gnumake gnumake 4.4.1 libedit libedit 20260508-3.1 nss-cacert nss-cacert 3.126 pkg-config-wrapper pkg-config-wrapper 0.29.2 stdenv-linux stdenv-linux 26.05pre-git zlib zlib 1.3.2 mbedtls mbedtls 3.6.7 libidn2 libidn2 2.3.8 xgcc xgcc 15.3.0 ncurses ncurses 6.6 libunistring libunistring 1.4.2
psi0.2.0
Runtime7 direct
  • argtable3.3.1

    Package license metadata: BSD-3-Clause

    1 dependencies
    • glibc2.42-84

      Package license metadata: LGPL-2.0-or-later

      2 dependencies
      • libidn22.3.8

        Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

        1 dependencies
        • libunistring1.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 dependencies
    • glibc2.42-84

      Package license metadata: LGPL-2.0-or-later

      2 dependencies
      • libidn22.3.8

        Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

        1 dependencies
        • libunistring1.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 dependencies
    • glibc2.42-84

      Package license metadata: LGPL-2.0-or-later

      2 dependencies
      • libidn22.3.8

        Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

        1 dependencies
        • libunistring1.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 dependencies
      • glibc2.42-84

        Package license metadata: LGPL-2.0-or-later

        2 dependencies
        • libidn22.3.8

          Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

          1 dependencies
          • libunistring1.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 dependencies
    • libidn22.3.8

      Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

      1 dependencies
      • libunistring1.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 dependencies
    • glibc2.42-84

      Package license metadata: LGPL-2.0-or-later

      2 dependencies
      • libidn22.3.8

        Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

        1 dependencies
        • libunistring1.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 dependencies
      • glibc2.42-84

        Package license metadata: LGPL-2.0-or-later

        2 dependencies
        • libidn22.3.8

          Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

          1 dependencies
          • libunistring1.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 dependencies
    • glibc2.42-84

      Package license metadata: LGPL-2.0-or-later

      2 dependencies
      • libidn22.3.8

        Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

        1 dependencies
        • libunistring1.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 dependencies
      • glibc2.42-84

        Package license metadata: LGPL-2.0-or-later

        2 dependencies
        • libidn22.3.8

          Package license metadata: GPL-2.0-or-later, GPL-3.0-or-later, LGPL-3.0-or-later

          1 dependencies
          • libunistring1.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 notes
  • Linux

    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.

Image coming soon!

Tested across i686, x86_64, aarch64, and riscv64 where available. See the porting notes for build details.

Extend with Lua

Explore the extension API

Add 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.

hello.lua
~/.config/psi/extensions›hello.lua
-- 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)
end

Install psi

Bring a model provider and a project.

nix run github:siraben/psi

Requires Nix with flakes enabled.

Configure your provider before the first agent turn. Provider setup