Getting started

Installation

Install the prebuilt CLI with a single command. Pick your platform below.

$ curl -fsSL https://raw.githubusercontent.com/in-th3-l00p/codel00p/main/install.sh | sh

Installs to ~/.local/bin. Set CODEL00P_INSTALL_DIR or CODEL00P_VERSION to customize.

Verify

codel00p --help

You should see the top-level commands: agent, memory, session, and mcp. If the command is not found, add the install directory to your PATH as the installer prints.

Note

Prebuilt binaries are published for macOS (Apple silicon and Intel), Linux (x86-64 and arm64), and Windows (x86-64) on each tagged release.

Desktop app

Prefer a graphical control center? The Electron desktop app ships from the same tagged GitHub Releases as the CLI. Download the installer for your platform from the desktop app page.

Uninstall

The CLI removes itself. It shows what will be deleted and asks for confirmation first:

codel00p uninstall

By default it deletes the binary and keeps your data. Flags:

--purge — also delete ~/.codel00p (config, credentials, saved sessions, and memory).
--yes / -y — skip the prompt (required in non-interactive shells).

If you added the install directory to your shell PATH, remove that line too. On Windows the running binary cannot delete itself, so the command prints its path for manual removal.