Spettro: Go로 작성된 터미널 기반 다중 에이전트 코딩 어시스턴트

Spettro는 Go 언어로 작성된 터미널(terminal-first) 기반의 다중 에이전트 코딩 어시스턴트입니다.

macOS 및 Linux:

curl -sSfL https://raw.githubusercontent.com/aploide/spettro/main/install.sh | sh

기본적으로 ~/.local/bin에 설치되며(sudo 불필요), INSTALL_DIR을 설정하여 경로를 재정의할 수 있습니다. 자체 업데이트(/update를 TUI에서 사용하거나 내장 업데이트 확인 기능)는 해당 디렉터리에 덮어쓰기(in place) 방식으로 작성되므로, 여전히 sudo가 필요하지 않습니다.

Windows (PowerShell):

irm https://raw.githubusercontent.com/aploide/spettro/main/install.ps1 | iex

사용자 PATH에 추가되며 %LOCALAPPDATA%\Programs\spettro에 설치됩니다. 권한 상승(elevation)이 필요 없으므로 /update도 제자리에서 작동합니다. Windows에서의 차이점은 docs/windows.md를 참조하십시오.

위의 파이프 형태는 인수를 받지 않습니다. -InstallDir(다른 곳에 설치), -Version(특정 릴리스 고정) 또는 -NoPathUpdate(PATH 유지)와 같은 인수를 전달하려면, 스크립트를 다운로드하여 실행해야 합니다:

irm https://raw.githubusercontent.com/aploide/spettro/main/install.ps1 -OutFile install.ps1
.\install.ps1 -InstallDir D:\tools\spettro -Version v1.2.3 -NoPathUpdate

이 시스템은 설정 가능한 에이전트 매니페스트(spettro.agents.toml 및 agents/*.md 프롬프트)를 사용하며, 네이티브 툴 호출을 통한 병렬 서브-에이전트 스폰(spawning)과 agent 툴을 활용합니다. 또한 계획(plan), 코딩(coding), 질문(ask), 탐색(explore), 코드(code), git, 테스트(test), 검토(review), 문서화(docs) 등 전문화된 오케스트레이터/워커 역할을 제공합니다.

• spettro.agents.toml 및 agents/*.md를 통한 설정 가능한 다중 에이전트 시스템
• 서브-에이전트의 병렬 네이티브 툴 호출 스폰 기능
• 권한 정책: ask-first, restricted, yolo
• 계획/코딩 실행 중 라이브 툴 트레이스(Live tool traces)
• 내장 툴 — 작업별 하나의 툴(bash, file-edit, grep, glob, todo-write, ...); 사용 중단된 중복 이름은 숨겨진 별칭으로 계속 작동합니다.
• 다크, 라이트 및 자동 테마 — /theme, 터미널 배경 감지, SPETTRO_THEME 환경 변수 지원
• OpenAI, Anthropic 및 OpenAI 호환 텍스트 호출을 위한 판타지 기반 제공자 라우팅(Fantasy-backed provider routing)
• models.dev를 통한 다중 공급자 모델 지원

카탈로그와 OpenAI 호환 엔드포인트 - 제공업체 전반에 걸쳐 정규화된 사고/추론 수준 ( /thinking off|low|medium|high|x-high|max )

워크플로우 — ultracode 작성 (또는 /ultra 켜기) 및 에이전트가 작업에 필요한 스크립트를 작성하여 서브 에이전트를 오케스트레이션합니다: 실행 시간에 계획되는 단계, 팬아웃(fan-out), 검증 루프, 중간 결과를 읽은 후 진행하는 체크포인트, 크기 계층(+500k) 토큰 예산, 재개 가능한 실행 - 대화형 PTY 세션 — 에이전트가 실제 터미널을 통해 REPL, 디버거 및 ssh를 구동합니다.

• 프로젝트별 대화 지속성 및 재개
• 폴더에서 처음 사용할 때 프로젝트 신뢰 프롬프트

요구 사항:

• Go 1.26.1+

git clone https://github.com/aploide/spettro
cd spettro
make build
...

대안:

go run ./cmd/spettro

최초 실행 시:

• 폴더 신뢰 확인.
• /connect를 실행하여 API 키(또는 로컬 엔드포인트) 추가. - /models를 실행하여 제공업체/모델 선택. - plan (기본 에이전트)으로 시작하고 Shift+Tab으로 전환합니다.

Spettro 명령어는 선행하는 /로 입력됩니다.

/help 도움말 텍스트 표시 /exit, /quit Spettro 종료 /mode, /next 활성 에이전트/모드 순환 /theme 색상 테마 선택기 열기 (다크/라이트/자동 미리보기 및 적용); /theme <dark|light|auto> 하나를 직접 설정합니다. auto는 터미널 배경을 감지합니다 (기본값). SPETTRO_THEME은 시작 시 팔레트를 선택합니다 /connect 제공업체 또는 로컬 엔드포인트 연결 /models [provider:model] [api_key] 선택기를 열거나 직접 설정 /permission <ask-first|restricted|yolo> 실행 정책 설정 /permissions [ask-first|restricted|yolo] 권한 표시/설정 /permissions debug <on|off> 권한 진단 토글 /budget <n|0> 요청 토큰 예산 설정 (0 = 무제한) /thinking <off|low|medium|high|x-high|max> 추론 수준 설정 (Anthropic thinking budget, OpenAI 스타일 reasoning_effort; 비추론 모델의 경우 숨겨져 있으며, 레벨이 거부되면 자동 폴백). /ultra [on|off]`

toggle ultra를 설정하거나 저장합니다 — ultracode: 동적 워크플로우로 실행되는 실질적인 작업 (ask-first에서 일시 중지)

; writeultracode

메시지를 통해 단일 턴으로 작성합니다)/workflows [list|show|run|size|where]

저장된 워크플로우 템플릿을 목록화하거나 표시하거나 실행하거나, 또는 워크플로우 크기 티어를 설정합니다 (writeultracode

메시지를 통해 에이전트에게 해당 턴의 워크플로우 도구를 전달합니다)/plan [prompt]

계획 모드로 전환하거나 계획 프롬프트를 실행합니다/approve

코딩 에이전트를 통해 보류 중인 승인된 계획을 실행합니다/tasks [list|add|done|set|show]

세션 작업을 관리합니다/mcp <list|read|auth>

MCP 리소스와 인증 토큰을 관리합니다/skills

에이전트 스킬 목록을 표시합니다;/<skill-name> [args]

또는$skill-name

하나를 실행합니다;/skill <install|info|uninstall|enable|disable|where|reload>

이를 관리합니다 (Claude Code / CodexSKILL.md

형식, 폴더도 읽힙니다)/hooks

효과적인 런타임 후크를 표시합니다/compact [focus]

대화 기록을 요약합니다/compact auto <status|on/off>

자동 압축을 구성합니다/compact policy

압축 임계값/카운터를 표시합니다/counters/clear

현재 대화를 자동 저장하고 지웁니다/resume

이전 저장된 대화를 불러옵니다/init

레포지토리를 분석하여 SPETTRO.md를 생성하거나 업데이트합니다

/remote [:port]

루프백 HTTP/SSE 제어 평면을 노출합니다 (docs/remote.md 참조)

)/remote local [:port]

제어 평면을 0.0.0.0의 LAN 장치에 노출합니다 (docs/remote.md 참조)

)/telegram setup <token>

Telegram 봇 중계기를 구성하여 채팅에서 Spettro를 구동할 수 있습니다 (docs/telegram.md 참조).
별칭:/tg

./<custom> [args]

~/.spettro/commands/ 또는 .spettro/commands/ 에서 저장된 자체 프롬프트를 실행합니다 (docs/custom-commands.md 참조)

전체 명령어와 키 바인딩은 docs/commands.md를 참조하세요.

spettro --acp

Spettro를 에이전트 클라이언트 프로토콜(Agent Client Protocol) 에이전트로 실행합니다 (stdio를 통해)
따라서 Zed와 같은 ACP 지원 편집기는 스트리밍 추론, 도구 호출 보고, 모드 전환 및 권한 프롬프트를 통해 네이티브 에이전트 패널에서 이를 구동할 수 있습니다. docs/acp.md를 참조하세요.

• 세션 수명 주기(Session Lifecycle) — 자동 저장(auto-save), 재개(resume), 압축(compact), 지우기(clear)
• 목표 모드(Goal Mode) — 자율적 실행
  /goal

runs - 런타임 후크(Runtime Hooks) — 사용자 지정 bash 미들웨어

• 클립보드 및 첨부 파일(Clipboard and Attachments) — 이미지 붙여넣기, 파일 첨부

• 첫 실행 온보딩(First-Launch Onboarding)

• Spettro 구독(Spettro Subscription) — 로그인, 요금제, 크레딧

• 에이전트 매니페스트(Agent Manifest)

• 에이전트 프롬프트(Agent Prompts)

• 에이전트 스킬(Agent Skills)

• 시작하기 및 워크플로우(Getting started and workflow)

• 명령어 및 키 바인딩(Commands and keybindings)

• 사용자 지정 슬래시 명령어(Custom slash commands) — 재사용 가능한 프롬프트를 자신만의 것으로 저장
  /commands

• 구성 및 스토리지(Configuration and storage)

• OS 샌드박싱(OS sandboxing)

• Windows 노트 — 설치, 셸, 샌드박스 및 PTY 차이점(Windows notes — install, shell, sandbox and PTY differences)

• 아키텍처 개요(Architecture overview)

• 원격 제어 평면(Remote control plane)

• 에이전트 클라이언트 프로토콜(Agent Client Protocol) (에디터 통합)

• Telegram 릴레이(Telegram relay)

• 테마(Themes) (다크, 라이트, 자동)

• 확장된 사고 수준(Extended thinking levels)

• 워크플로우(Workflows)

• 문제 해결(Troubleshooting)

• 문서 색인(Documentation Index)

make test
make build
make build-all