raw-cli
Обвязка для своего агента: цикл инструментов, сессии, согласования, REPL и дашборд, где инструмент и скилл лежат в файлах.
- 108 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструменты `bash`, `write_file` и `edit_file` выполняются без запроса с правами вашей учетной записи, `cwd` не изолирует файлы.
- Дашборд с флагом `--remote` открывает локальный интерфейс агента на телефоне через туннель Cloudflare.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/raw-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты `bash`, `write_file` и `edit_file` выполняются без запроса с правами вашей учетной записи, `cwd` не изолирует файлы.
- Дашборд с флагом `--remote` открывает локальный интерфейс агента на телефоне через туннель Cloudflare.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
raw — CLI с готовой обвязкой для собственного агента: цикл вызова инструментов, сжатие контекста, сохраняемые сессии, согласования, REPL в терминале, локальный дашборд в браузере и протокол ACP для редакторов. Все, что делает агент, лежит в файлах, которые можно менять: инструменты, скиллы на Markdown, хуки и правила доступа. В комплекте четырнадцать инструментов-плагинов, среди них `read_file`, `write_file`, `edit_file`, `bash`, `apply_patch`, `todo` и `process`. Модели подключаются через конфиг по API OpenAI, Anthropic и Google, в том числе локальные через Ollama. Выбранные MCP-серверы добавляют инструменты, а готового агента вместе с инструментами и скиллами упаковывают в `.rawpkg`.
Для кого. Разработчикам, которые строят внутреннего, кодового или операционного агента и хотят менять части готовой обвязки без написания цикла с нуля.
Подходит, если
- Внутреннему агенту нужны собственные инструменты и правила доступа.
- Модель работает локально через Ollama, и ей дают минимальный набор инструментов.
- Агента вместе с инструментами и скиллами передают коллегам файлом `.rawpkg`.
- Редактор подключает агента по протоколу ACP.
Не подходит, если
- Нужна песочница: `cwd` только разрешает относительные пути и ничего не изолирует.
- Хотят готового ассистента без настройки конфига и моделей.
- На машине стоит Node.js старее 22.13.
Пример запроса к агенту
Запусти `raw --agent raw "Explain the tests in this repository"` и покажи, какие файлы агент прочитал.Ограничения
Нужны Node.js 22.13 или новее и Bash для инструмента `bash`; на Windows без Git Bash выбирается `powershell`. Вызовы инструментов выполняются автоматически с правами вашей учетной записи ОС, а `cwd` не служит песочницей. Без правила `ask` или `deny` в `tools.rules` команда запускается без запроса. Сжатие и кеш контекста зависят от модели и API, а поддержку изображений включают у модели отдельно. Стоимость запросов к платным API ложится на ваш ключ.
Как отключить. Удалите пакет командой `npm uninstall -g @tlelabs/raw`. Конфиг `~/.config/raw/` и каталог сессий `~/.local/state/raw/` лежат в домашнем каталоге по умолчанию, их удаляют вручную.
Частые вопросы
Как установить и запустить raw?
`npm install -g @tlelabs/raw`, затем `raw config init` создаст `~/.config/raw/config.json` с агентом `raw`. Разово запустить без установки можно через `npx @tlelabs/raw --help`.
Какие модели можно подключить?
Любые, у которых есть один из четырех способов API: `openai-chat-completions`, `openai-responses`, `anthropic-messages` или `google-generate-content`. В конфиге задают `model_id`, `base_url` и `api_key_env`.
Как ограничить действия агента?
Через `tools.rules` агента. Правила `allow`, `ask` и `deny` сопоставляются с инструментом или шаблоном, например с командой `rm` у `bash`. Флаг `-y` не обходит явное правило `ask`.
Как передать агента коллеге?
Экспортируйте агента командой `raw package export`, упакуйте через `raw package pack` в `.rawpkg` и установите на другой машине командой `raw package install`. Модель получателя привязывают через `raw agent add`.
Что показывает дашборд?
`raw dashboard` открывает локальное приложение в браузере: сессии, вызовы инструментов, использование контекста, запросы на согласование и настройки. Флаг `--remote` открывает его и на телефоне через туннель Cloudflare.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыАгент для кода без интерфейса в одном бинарнике на Go: читает и правит файлы, запускает команды и не обрезает контекст молча
Каркас из персон, правил и скиллов в чистом Markdown: Maestro раздает работу разным моделям и экономит основной тариф
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
Один рантайм для Claude Code, Codex, OpenCode и других: работа принята, только если пройдены проверки, которые агент не писал
rsc-harness, CLI для настройки агентов, согласует скиллы и правила проекта через план, который пользователь принимает до записи.
Учебный терминальный агент для кода на Python, задуманный как «nanoGPT для агентов»: прочитать, разобрать и форкнуть
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| raw-cli (эта карточка) | нет | 108 | |
| MiniCode | нет | 1 161 | компактный терминальный кодинг-агент с интерфейсом TUI; raw-cli добавляет сессии, дашборд, согласования и упаковку агентов |
| MetaHarness | нет | 739 | собирает из репозитория пакет с агентом; raw-cli дает обвязку, в которой инструменты и правила правят как файлы |
Коротко о README
Документация лежит на raw.tlelabs.com, в репозитории есть руководства по конфигурации, инструментам, скиллам, MCP, хукам, ACP и дашборду. В поставку входят примеры инструментов и готовый агент `project-helper`.