코딩 에이전트를 지켜보지 않고 작동하게 하세요.
agentproto는 Claude Code, Codex, Hermes, opencode, Mastra, 그리고 다른 모든 코딩 에이전트를 백그라운드에서 실행하고, 이들을 한 곳에 보여주며, 커밋되기 전에 테스트나 리뷰어 모델을 통해 각 작업물을 확인합니다. 더 이상 터미널 창을 지켜볼 필요가 없습니다.
- 모두 동일한 방식으로 작동하게 하세요. 시작, 메시지 전송, 관찰, 중지 등 모든 에이전트를 같은 명령어로 제어할 수 있습니다. 오늘날 15개의 에이전트가 하나의 라이프사이클 아래에 존재합니다.
- 적용되기 전에 검증하세요. 테스트나 변경 사항을 검토하는 더 강력한 모델과 같은 검사(check)를 연결하면, 에이전트가 완료될 때마다 실행됩니다. 커밋은 당신의 OK와 검사를 기다리며, 심지어 노트북을 닫은 후에도 그렇습니다.
- 가지고 있는 도구를 유지하세요. 이미 사용하고 있는 에이전트 CLI를 구동합니다 — 다시 작성할 필요가 없습니다. 에이전트는 다른 에이전트를 실행하고 검사하는 것까지 가능합니다.
- 그리고 주변에 완전한 툴박스를 갖추세요. 파일을 작성하여 도구로 제공하거나, 모든 MCP 서버를 가져와서 어떤 에이전트에게든 전달하고, 터널을 열고, 브라우저를 구동하며, 워크플로우 및 cron 실행을 예약할 수 있습니다.
데몬(daemon)은 더 큰 무언가의 플래그십 표면입니다: agentproto는 오픈 에이전틱 프레임워크입니다 — AIP specs는 모든 에이전트 구성 요소(도구, 스킬, 에이전트, 지식, 워크플로우, 정책)를 선언된 계약을 가진 일반 파일로 정의하며, 이 레포지토리는 이를 로드하고 실행하며 어떤 호스트(CLI, HTTP, MCP, Mastra, Vercel AI SDK)에도 투영하는 TypeScript 런타임입니다. 계약이 있는 파일이야말로 모든 런타임이 그것들을 로드할 수 있게 하며, 에이전트가 자신의 구성 요소를 읽고, 쓰고, 개선할 수 있도록 합니다.
상태: 1.10.0. API는 안정화되고 있습니다. 릴리스 간에 사소한 호환성 문제가 발생할 수 있으니 유의하세요.
빠른 시작 (Quick start)
또는 한 줄로 제로(zero)부터 부트스트랩 할 수 있습니다:
curl -fsSL https://raw.githubusercontent.com/agentproto/ts/main/scripts/bootstrap/install.sh | bash
# Windows 10/11 (PowerShell 5.1+)
irm https://raw.githubusercontent.com/agentproto/ts/main/scripts/bootstrap/install.ps1 | iex
수동 경로(Manual path):
npm i -g @agentproto/cli
agentproto install claude-code
agentproto serve
...
그런 다음 게이트를 설정하세요: 모든 세션의 턴 종료 시점에 정책을 첨부하고 인간의 승인(ack) 뒤에 커밋 단계를 거칩니다. 전체 내용은 agentproto.sh에서 확인하거나, 아래의 정확한 구분을 위해 바로 agentproto.sh/features로 이동하세요.
현재 출시된 기능 vs. 로드맵
이 저장소는 하나의 이름 아래 매우 다른 두 가지 것을 배포합니다:
- Tier 1 — 실시간, 검증된 실습: 데몬, CLI, 15개의 에이전트 어댑터(Claude Code, Claude SDK, Codex, Gemini, Grok CLI, Hermes, jcode, opencode, Mastra Code + 인프로세스, Mastra Agent, OpenClaw, browser-as-agent, Antigravity, pi), 영속적인 정책 게이트, 역할 게이팅을 포함한 중첩 오케스트레이션, 팬인 모니터링, 워크플로우/cron, 그리고 데몬 자체의 MCP 표면(~175개 도구).
- Tier 2 — 더 광범위한 AIP 사양군: agentproto/agentproto에 존재하는 ~52개의 번호가 매겨진 사양들. Tier 1을 넘어서는 대부분의 참조 구현 패키지는
0.1.0-alpha 스캐폴딩이며, 실제 스키마와 의도(intent)를 담고 있지만 아직 운영 가능한 소프트웨어는 아닙니다.
전체 분석: https://agentproto.sh/features. 만약 Tier 2의 내용 중 배포된 것처럼 보이는 부분이 있다면 이슈를 제출해 주세요. 이 구분이 계약 사항입니다.
어댑터 기여하기
어댑터 계약은 간단합니다: AIP-45 매니페스트를 통해 models[]와 modes[]를 선언하고, 라이프사이클 동사(verbs)를 구현하며, 공유된 provider-kit 기본 요소(자격 증명(creds), 카탈로그 항목, 설정/상태 도구)를 재사용합니다. 명백한 공백: Cursor (agent CLI, ACP 지원 — 종단 간 검증되지 않음), aider, goose, cline, Continue. 전체 참조 구현은 adapters/claude-code에서 확인하고, 트래커에서 good first issue 레이블을 찾아보세요.
VS Code 확장 프로그램
packages/vscode에는 private agentproto-vscode 확장이 포함되어 있습니다. 이 확장은 데몬 세션 및 권한에 대한 로컬 운영 뷰와 에디터에서 에이전트를 관리하는 명령을 제공합니다. 모든 Releases 자산은 CI(지속적 통합) 환경에서 빌드되며, 레포지토리에 커밋된 적이 없습니다:
- Dev builds —
packages/vscode를 건드리는 main으로 푸시가 발생할 때마다, 가장 최신 버전을 가져갈 수 있는 vscode-dev-<sha> 태그가 지정된 프리릴리즈 VSIX 파일이 게시됩니다.
- Official releases — vscode 변경 사항을 포함하는 "Version Packages" PR 병합 시점에 버전이 지정된 VSIX 파일인
vscode-v<version>이 게시되며, 이는 다른 모든 패키지의 릴리스와 동일한 주기를 가집니다.
VS Code의 Extensions: Install from VSIX... 명령을 통해 설치하거나, 직접 빌드하려면 다음 단계를 따르세요:
cd packages/vscode
pnpm package
unzip -t agentproto-vscode-*.vsix
개발 및 검증 명령어는 packages/vscode/README.md를 참조하세요.
Packages
이 레포지토리는 다섯 개의 레이어로 구성되어 있으며, 각 레이어는 packages/ 또는 adapters/ 아래의 형제 서브트리(sibling subtree)입니다.
1 — Runtime & daemon
@agentproto/runtime은 워크스페이스를 라이브 AIP runtime으로 변환하는 장기 실행 게이트웨이입니다. 여기에는 세션 관리, MCP 서버, HTTP 전송 계층, HEARTBEAT 자율 루프, 그리고 append-only 대화 지속성 기능이 포함됩니다.
packages/runtime/ @agentproto/runtime 세션 수명 주기, MCP 도구, HTTP API, 감독자(supervisor) / 오케스트레이터
packages/cli/ @agentproto/cli `agentproto` 바이너리 — 어댑터 설치, 세션 실행/서비스, 데몬
packages/mcp-server/ @agentproto/mcp-server 도큐먼트 타입별 CRUD MCP 도구 (생성/로드/목록 보기/업데이트/해결/삭제)
런타임에서 노출하는 주요 MCP 도구:
| Tool | Purpose |
|---|
agent_start / agent_prompt / agent_output / agent_kill / agent_interrupt | 장기 실행 에이전트-CLI 세션 시작, 구동, 중단 및 정지 |
| ... | |
2 — Adapter families
packages/provider-kit/ @agentproto/provider-kit 공유 카탈로그, 자격 증명(creds), 설정 레저(setup-ledger), MCP 도구 프리미티브
packages/provider-presets/ @agentproto/provider-presets 공유 게이트웨이 프리셋 레지스트리 (Anthropic, Moonshot, OpenRouter, Requesty, DeepSeek, xAI, xAI-Anthropic, LLM Endpoint)
...
모든 agent-CLI 어댑터는 provider-kit의 프리미티브를 공유합니다: makeSetupTool (단일 필드 또는 다중 필드 자격 증명), computeStatus, AdapterCatalogEntry, 그리고 makeCredsStore. mastra-agent만 예외적입니다. 다른 모든 어댑터는 외부 에이전트 CLI를 래핑하는 반면, mastra-agent는 처음부터 끝까지 저희의 것입니다 — 데몬에 의해 어떤 arm이나 독립형으로 agentproto-mastra acp를 통해 생성되는 라이브 Mastra 에이전트로서 실행되는 AGENT.md (저희의 루프, 저희의 모델)입니다.
런타임 내부에서 사용되거나 호스트 프레임워크로 투영되는 도구를 위한 원래의 세 계층 모델: 계약(contract) → 구현(implementation) → 번들(bundle).
packages/tool/ @agentproto/tool AIP-14 defineTool, ToolHandle, validators
packages/driver/ @agentproto/driver AIP-30 implementTool, defineDriver, runTool, resolver
packages/driver/cli/ @agentproto/driver-cli AIP-29 CLI/subprocess 전송(transport)
...
import { defineTool } from "@agentproto/tool"
import { implementTool, defineDriver } from "@agentproto/driver"
import { z } from "zod"
...
어떤 ToolImplementation이든 호스트 프레임워크의 도구 형태로 재표현(Re-express)할 수 있습니다:
adapters/ai-sdk/ @agentproto/adapter-ai-sdk Vercel AI SDK 도구 투영(projection)
adapters/mastra/ @agentproto/adapter-mastra Mastra createTool 투영(projection)
packages/mastra/ @agentproto/mastra AIP-42 AGENT.md → Mastra Agent
import { toAiSdkTool } from "@agentproto/adapter-ai-sdk"
import { toMastraTool } from "@agentproto/adapter-mastra"
...
4 — 지식 및 워크플로우(Knowledge & workflow)
packages/corpus/ @agentproto/corpus AIP-10/12/18 지식 구성(knowledge composition) (순수, I/O 없음)
packages/corpus-cli/ @agentproto/corpus-cli corpus 바이너리 — 코퍼스 작업 공간 검증, 린트, 작동
packages/workflow-runtime/ @agentproto/workflow-runtime AIP-15 타입 단계 워커(typed step-walker) (도구/맵/분기/루프/변환)
...
@agentproto/corpus는 AIP-10 지식, AIP-12 플레이북, AIP-18 컬렉션, AIP-9 오퍼레이터, AIP-15 워크플로우, 그리고 AIP-41 루틴을 통합하여 자율적인 지식 개선 시스템(autonomous knowledge-improvement system)으로 만듭니다. 순수(Pure): 런타임 없음, 파일시스템 없음, HTTP 없음 — 모든 I/O는 주입된 포트(injected ports)를 통해 처리됩니다.
5 — 플랫폼: 인증(auth), 샌드박스(sandbox), 비밀 정보(secrets), 원격 측정(telemetry)
packages/auth/ @agentproto/auth 플러그형 자격 증명 저장소(Pluggable CredentialStore) + 디바이스 코드 (RFC 8628) 인증 흐름
packages/sandbox/ @agentproto/sandbox agent_start.sandbox: 격리된 박스 부팅/재연결/일시 중지
packages/secrets/ @agentproto/secrets 브로커가 해결한 프로비저닝 인증 헤더, mcp-header 노출
...
사양(Specifications)
AIP 마크다운 사양은 agentproto/agentproto에 있습니다. 렌더링된 버전은 https://agentproto.sh/docs에서 찾아보세요.
여기서 구현된 주요 사양:
| AIP | 사양(Spec) | 패키지(Package) |
|---|
| AIP-9 | OPERATOR.md | @agentproto/operator |
| ... | | |
소스에서 빌드하기
pnpm install
pnpm -r build
pnpm -r test
라이선스
Apache-2.0 — LICENSE 참조. Copyright 2026 Jeremy André 및 agentproto 기여자.
기여(Contributing)
사양의 진화는 agentproto/agentproto에서 이루어집니다. 이 저장소는 AIP 진행 상황을 추적하며, 구현은 AIP가 검토(Review)/최종(Final) 상태에 도달함에 따라 뒤따릅니다. 런타임 버그 수정, 성능 개선, 어댑터 커버리지 관련 PR 환영합니다 — 위