agentsys

AI Agent OrchestrationCLIJavaScript

★ 985주당 +3조회 4

무엇인가

AI 모델이 코드를 쓰는 부분은 이미 해결된 문제로 두고, 그 바깥의 작업을 자동화하는 계층이다. 작업 선택, 브랜치 관리, 코드 리뷰, 산출물 정리, CI, PR 코멘트, 배포가 대상이다. 플러그인은 agent-sh 조직 아래 개별 저장소로 배포되며, agentsys는 그것들을 묶는 마켓플레이스 겸 설치기다.

어떻게 동작하나

구성 단위는 플러그인·에이전트·스킬 세 가지다. 에이전트는 단일 책임과 지정된 모델, 정의된 입출력을 가지며, 스킬은 재사용 가능한 구현 단위로 에이전트가 호출한다. 커맨드가 에이전트를 오케스트레이션하고, 파이프라인은 단계 게이트를 강제해 에이전트가 순서를 건너뛰지 못하게 한다. 상태는 세션 경계를 넘어 유지된다. /next-task는 작업 소스 선택(GitHub Issues, GitHub Projects, GitLab, 로컬 파일) → 상위 5개 작업 제시 → 워크트리 생성 → 코드베이스 탐색 → 계획 수립 → 사용자 승인 순으로 진행한다.

무엇과 다른가

탐지와 판단을 분리한다. 정규식·AST 분석·정적 분석으로 결정적으로 찾아낼 수 있는 것은 토큰을 쓰지 않고, 합성·계획·리뷰처럼 추론이 필요한 지점만 LLM을 호출한다. 이 구조로 /drift-detect는 다중 에이전트 방식 대비 토큰을 77% 덜 쓴다. 결과에는 확신 등급이 붙는다. 2026년 3월 glide-mq 저장소에서 /can-i-help와 /onboard를 claude -p --output-format json으로 측정한 결과, Sonnet + agentsys가 raw Opus보다 구체적인 출력을 40% 낮은 비용으로 냈다.

어떻게 쓰나

설치는 마켓플레이스나 npm 설치기를 통해 이루어지고, 플러그인은 각자의 저장소에서 자동으로 내려받아진다. agentsys install이 기본 경로이고, Codex와 OpenCode는 agentsys --tool codex, agentsys --tool opencode로 설치한다. 각 커맨드는 단독으로 실행되며, 조합하면 엔드투엔드 파이프라인이 된다. 플러그인을 설치하면 그 스킬이 해당 세션의 모든 에이전트에서 쓸 수 있게 된다.

전제와 한계

Claude Code, Codex CLI, OpenCode, Cursor, Kiro 다섯 플랫폼에서 동작한다. Windows에서는 Claude Code 실행 파일을 where.exe로 찾고 .cmd 심을 cmd.exe를 거쳐 실행한다. agentsys install은 Claude Code가 플러그인을 거부하면 성공을 출력하는 대신 실패를 보고하고 0이 아닌 코드로 종료한다. glide-mq 같은 스킬 전용 플러그인은 Valkey/Redis를 요구한다.

관련 논문 4

유사 도구