localix-cli README

README проекта с github.com/localixai/localix-cli. Одним файлом markdown: 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)

Ищем в базе…

Что это такое?Агент для написания кода в терминале, написанный на Rust. Это один исполняемый файл размером менее 4 МБ, который работает с любой моделью, в том числе с моделями на вашем собственном компьютере. Команда называется llx.
Это библиотека или программа, которую я запускаю?Это программа для командной строки, которую вы запускаете внутри своего проекта, а не библиотека. Тот же агент может работать и без диалога в CI через llx exec.
Как мне его запустить?Запустите скрипт установки на macOS или Linux, затем запустите llx в своём проекте. Введите /login, чтобы войти с аккаунтом ChatGPT, ключом OpenRouter, ключом одного из 200+ провайдеров или использовать локальную модель.
Нужно ли сначала завести аккаунт или ключ?Не обязательно. Нужна какая-то модель: вход через ChatGPT, ключ OpenRouter, собственный ключ провайдера или локальная модель, например Ollama или LM Studio, которая не требует ключа. Команда llx doctor покажет, чего не хватает.
Работает ли это на Windows?В README описаны шаги установки только для macOS и Linux, поэтому поддержка Windows не указана.
Какие инструменты агент использует на самом деле?Это модель, которая работает в цикле с пятью инструментами: bash, applypatch, ask, agents и jobs. Она читает, ищет и запускает проверки через командную оболочку, а файлы меняет с помощью патчей.
Как это запускать в CI или скрипте?llx exec даёт агенту одну задачу и возвращает ответ в формате JSON Schema, если вы его передадите. Коды выхода (0 — готово, 1 — нет данных, 2 — закончились ходы, время или бюджет, 3 — ошибка) позволяют конвейеру ветвиться в зависимости от результата.
Могут ли другие агенты использовать llx?Да. Claude Code, Codex или скрипт может вызвать llx exec из своей командной оболочки, чтобы передать задачу помощнику на любой модели. Команда llx decide выбирает один из нескольких вариантов для какого-либо текста примерно за секунду. Также есть навык (skill) и плагин для Claude Code.
Это новый проект или более старый?Это преемник auto-copilot-cli, инструмента командной строки 2023 года на TypeScript от того же автора. llx переписан с нуля на Rust.
Какие есть похожие проекты?dscode, octomind, DeepCode, memdoor, Raven, oh-my-pi, gentle-shell, Agent
Автор
localixai
Размер
16.2 MB
Звёзды
368
Возраст
3 г
Коммиты · 90 дней