localix-cli README

The project's README from github.com/localixai/localix-cli. As one markdown file: README.md.

Localix CLI

Localix CLI

An ultrafast, lightweight agent runtime for coding and CI

A coding agent at your terminal, on any model: a ChatGPT sign-in, OpenRouter, your own key or a local model (Ollama, LM Studio, llama.cpp). The same agent runs one task in CI and helps your other agents. One binary under 4 MB.

CI status Latest release MIT License macOS and Linux

Quick start · At your terminal · Measured · In CI · In other agents · Docs · cli.localix.ai

llx at a terminal, every step a real run on Claude Haiku 5.5: a model is picked, a failing test is fixed, answers are drawn with steps, tabs, a table and a formula, two agents work in parallel

Every step a real run on Claude Haiku 5.5: any model · a fix · answers · agents · a decision · a ship check. It plays on cli.localix.ai too, by chapter, where it can be paused and copied from.

Quick start

1. Install on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/localixai/localix-cli/main/scripts/install.sh | sh

2. Run it in your project:

cd your-project
llx

3. Sign in and ask:

/login
the median test fails, fix it

/login takes a ChatGPT sign-in, OpenRouter or a key for any of 200+ providers; a model on your own machine (Ollama, LM Studio) needs none. llx doctor says what is missing. Other ways to install: Installing llx.

Installed with the script? Run llx --update to install the latest stable release. A session only notifies you when one is available.

Why llx

llx is a model in a loop over five tools: bash, apply_patch, ask, agents and jobs. It reads, searches and runs your checks through the shell, and changes files with patches.

At your terminal

What finished goes into the terminal's own scrollback, so scrolling, selecting and copying stay the terminal's. Several sessions can work in one project at once, each with agents of its own.

An answer as llx draws it in a terminal: a file tree, code under its file's name, a diff, a formula, a quote with its source and a footnote An answer as llx draws it in a terminal: figures side by side, a table, a task list, the case for and against, and sources by number

The renderer's own rows, written as SVG. The Markdown is read by flowdown, the lab's library.

Key What it does
Enter Sends. While a task works, what you type goes to it, read at its next step
Shift+Tab Goes round the modes: default → plan (read-only) → bypass → your own
/ The commands: /login, /model, /mode, /new, /rewind, /diff, /copy, /usage and more
@ Mentions a file of the project; a dragged file or picture is attached
← On an empty prompt, lists the sessions in this project
Esc, Ctrl+C Steps back out of what is open; Ctrl+C also stops work

Every key and command: Using llx.

Measured beside Claude Code

The same task, the same model, the same Anthropic key, started in the same minute; the tests that score a run were written before it.

Task Model Agent Solved Time Turns Cost
evalkit, 238 tests Haiku 5.5 llx 238 of 238 286 s 14 $0.050
Claude Code 2.1.321 238 of 238 478 s 25 $0.46
shopkit, 69 tests Haiku 5.5 llx 69 of 69 69 s 5 $0.012
Claude Code 2.1.321 69 of 69 67 s 4 $0.011

One run of each agent, on one machine: a measurement, not a law. Every run's log, code and test output are in benchmark/, the slower runs too (history); bun benchmark/run.ts repeats it on your key.

In CI and scripts

llx exec is the same agent given one task: it ends with an answer, in the shape a JSON Schema defines if you pass one, and an exit code your pipeline can branch on (0 done, 1 no data, 2 out of turns, time or budget, 3 error). It works through bash with gh, git and your project's tools, with no MCP server and no built-in prompt, so the same task runs on GitHub, GitLab or any runner with a shell.

# a step of a job, after actions/checkout
- uses: localixai/localix-cli@v0
  id: llx
  env:
    OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
    GH_TOKEN: ${{ github.token }} # read-only in this job; a second job posts the answer
    PR: ${{ github.event.pull_request.number }}
  with:
    model: anthropic/claude-haiku-5.5
    allow: bash
    schema: '{"type":"object","properties":{"summary":{"type":"string"}},"required":["summary"]}'
    prompt: |
      Review pull request #$PR with gh and git. Run something to confirm a problem
      before you report it.

Ready-made workflows, each run for real: a pull request review, @llx in any thread, issue triage, a failed run explained and more. The action, the two-job pattern, keys, limits and GitLab: CI. Exit codes and the --json events: Reference.

In other agents

Claude Code, Codex or a script of yours can call llx from its shell: llx exec hands a task to a helper on any model, so the agent's own tokens go where they matter, and llx decide picks one of a few options about some text in about a second. A skill tells any agent that takes skills when each pays:

npx skills add localixai/localix-cli

In Claude Code it is also a plugin: /plugin install llx --marketplace localixai/localix-cli. More: In other agents.

Documentation

All of it is also on cli.localix.ai/docs.

Guide What it holds
Installing llx The install script, other ways, pinning a release, signing in
Using llx The command line, a session key by key, models and local hosts, sessions, project instructions
Modes and trust Modes, rules, approvals, the sandbox and its boundaries
Tools The five tools: bash, apply_patch, ask, agents, jobs
CI · Recipes · Examples The GitHub Action, the two-job pattern, shell recipes, ready-made workflows
In other agents Helpers on any model, llx decide, the skill
Reference · Compared Exit codes, --json events, llx decide; the action beside other agents' actions
Architecture · Models · Changelog The layers and their rules, the model catalog, what changed

Contributing

Start with CONTRIBUTING.md and ARCHITECTURE.md. Report vulnerabilities as SECURITY.md describes. llx is open source under the MIT License, made by Localix Lab, built and reviewed with Claude Fable 5.2.

Before Localix CLI, this repository was auto-copilot-cli (2023, TypeScript), its author's first AI command line. llx is its successor, written anew in Rust.

localix-cli (localixai/localix-cli)

Searching Database…

What is this?A coding agent for your terminal, written in Rust. It is one binary under 4 MB that works with any model, including ones on your own machine. The command is llx.
Is it a library or a program I run?It is a command-line program you run inside your project, not a library. The same agent also runs non-interactively in CI through llx exec.
How do I get it running?Run the install script on macOS or Linux, then run llx in your project. Type /login to sign in with a ChatGPT account, an OpenRouter key, a key for one of 200+ providers, or a local model.
Do I need an account or a key first?Not necessarily. You need some model: a ChatGPT sign-in, an OpenRouter key, your own provider key, or a local model such as Ollama or LM Studio, which needs no key. Running llx doctor shows what is missing.
Does it run on Windows?The README gives install steps only for macOS and Linux, so Windows support is not stated.
What tools does the agent actually use?It is a model in a loop over five tools: bash, applypatch, ask, agents and jobs. It reads, searches and runs checks through the shell and changes files with patches.
How can it run in CI or a script?llx exec gives the agent one task and returns an answer, in a JSON Schema shape if you pass one. Its exit codes (0 done, 1 no data, 2 out of turns, time or budget, 3 error) let a pipeline branch on the result.
Can other agents use llx?Yes. Claude Code, Codex or a script can call llx exec from its shell to hand off a task to a helper on any model. llx decide picks one of a few options about some text in about a second, and there is a skill and a Claude Code plugin.
Is this a new project or an older one?It is the successor to auto-copilot-cli, a 2023 TypeScript command-line tool by the same author. llx was rewritten from scratch in Rust.
What are similar projects?dscode, octomind, DeepCode, memdoor, Raven, oh-my-pi, gentle-shell, Agent
Creator
localixai
Size
16.2 MB
Stars
368
Age
3y
Commits · 90 Days