Stell

AI coding agent — терминальное приложение для работы с LLM-моделями в контексте вашего кода.

Установка

go install github.com/stelmakhdigital/stell/cmd/stell@latest

Или через Make:

make build
./bin/stell

Быстрый старт

# Интерактивный режим (TUI)
stell

# Один промпт и выход
stell -p "refactor this function"

# RPC-режим (JSONL over stdin/stdout)
stell --mode rpc

# Вызов tool без агента (отладка extensions / builtins)
stell tool invoke read --args '{"path":"README.md"}'
stell tool invoke echo --args '{"text":"hi"}' -e ./examples/extension-echo
stell extension list -e ./examples/extension-echo
stell extension init my-ext

# Marketplace (catalog)
export STELL_PACKAGE_CATALOG=./examples/marketplace/catalog.json
stell search echo
stell info stell/extension-echo

Структура проекта

├── cmd/                    # Entry points
│   ├── stell/              # Основной бинарник
│   └── orchestrator/       # Менеджер инстансов
├── pkg/                    # Публичные библиотеки (готовы к выносу в отдельные репозитории)
│   ├── ai/                 # LLM-слой: типы, провайдеры, auth, стриминг
│   ├── agent/              # Ядро агента: Loop, tools, session, hooks
│   └── tui/                # Terminal UI фреймворк
├── internal/               # Приватная логика приложения
│   ├── agent/              # Продуктовая обёртка над pkg/agent
│   ├── app/                # Общий composition root (CLI + SDK)
│   ├── tui/                # UI-компоненты приложения
│   ├── config/             # Конфигурация и настройки
│   ├── extensions/         # Система расширений (plugins)
│   ├── rpc/                # JSONL RPC-сервер
│   ├── orchestrator/       # IPC-управление инстансами
│   ├── sdk/                # In-process Go API (только внутри модуля)
│   └── ...

Правило импортов

cmd/        → internal/*, pkg/*
internal/*  → pkg/*, internal/* (другие пакеты)
pkg/*       → pkg/* (другие пакеты), стандартная библиотека
             ⛔ pkg/* НЕ импортирует internal/*

Настройка модели

Конфиг в ~/.stell/config.json. Доступные провайдеры: OpenAI, Anthropic, Ollama, Codex и др.

stell models          # список доступных моделей
stell config          # открытие конфига

API

• TUI — интерактивный терминальный интерфейс
• RPC — JSONL-протокол через --mode rpc (встраивание из любого языка)
• SDK — in-process Go API (internal/sdk, не импортируется извне модуля)

Лицензия

MIT