AgentWorks: 목표를 추적하는 AI 에이전트 플랫폼

누구에게 적합한가

AgentWorks의 공식 포지셔닝은 소스 공개형(source-available) 목표 기반 AI 에이전트 플랫폼입니다. 에이전트에 목표 지표를 하나 정해 주면, 그 지표에 도달할 때까지 계속 작업합니다. Claude Code, Codex, Cursor, Pi, Muse 같은 코딩 에이전트 CLI를 이미 쓰고 있다면, 기존 CLI 위에서 곧바로 동작합니다.

동시에 MCP 서버이기도 합니다. ChatGPT, Claude(Desktop, Code, Cowork) 또는 임의의 MCP 클라이언트 채팅에서 곧바로 목표를 조회하고, 리포트를 읽고, 실행을 시작하고 싶다면 잘 맞습니다.

주의할 전제: 공식이 설명하는 설치 경로는 macOS만 다룹니다(/Applications에 설치, macOS 격리 플래그 제거, 필요 시 Homebrew를 통한 Go 설치). 다른 운영체제는 언급되지 않았습니다. 개봉 즉시 쓸 수 있는 매니지드 서비스도 아니며, 첫 실행 시 로컬 워크스페이스 폴더를 직접 선택하고 AUTH_SECRET을 설정해야 합니다.

3분 만에 첫 사용 완료하기

전제: macOS 머신 한 대와 터미널. 스크립트는 필요할 때 Homebrew를 통해 Go를 추가 설치합니다.

터미널에서 공식 한 줄 설치 명령을 실행합니다:

curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash

Enter를 누르기 전에 부작용을 먼저 확인하세요: 스크립트는 최신 릴리스를 다운로드하고, AgentWorks.app을 /Applications에 설치하고, Claude Code와 Codex가 도구 접근에 사용하는 MCP bridge(~/go/bin에 설치)를 설치하고, macOS 격리 플래그를 제거한 뒤 앱을 실행합니다. 이는 로컬 쓰기를 동반하는 설치 작업이지 읽기 전용 작업이 아닙니다. 원격 스크립트가 걱정되면 먼저 브라우저에서 해당 URL의 내용을 확인하세요.

첫 실행 설정: 앱의 안내에 따라 워크스페이스 폴더를 선택하고 AUTH_SECRET을 설정합니다. 이 값은 프로바이더 키를 암호화하는 데 사용되며, 같은 워크스페이스를 여러 머신에서 연다면 모든 머신에서 같은 값을 재사용해야 합니다.

낮은 위험도의 첫 호출: 설치 스크립트가 이미 Claude Code와 Codex용 MCP bridge를 설치해 두었으므로, Claude Code에서 목표 조회(check goals)나 리포트 읽기(read reports)를 요청해 보세요. 이는 공식에 설명된 읽기 계열 능력이며 실행을 유발하지 않습니다. 성공 신호: Claude Code가 목표 상태 또는 리포트 내용을 반환하는 것. 다른 MCP 클라이언트(ChatGPT, Claude Desktop 등)의 연동 절차는 공식 페이지에 없으며, 여기서 임의로 대신 만들지 않습니다.

사용 사례

사례 1: 채팅에서 진행 상황 조회, 리포트 읽기. 상황: 지표를 추적하는 목표를 이미 AgentWorks에 맡겨 두었고, 일상 대화 속에서 진행 상황을 알고 싶다. 방법: 연동된 클라이언트에서 자연어로 목표 조회와 리포트 읽기(check goals, read reports)를 요청합니다. 기대할 수 있는 결과: 공식은 해당 채팅에서 목표 확인과 리포트 읽기를 명시적으로 지원합니다. 구체적인 반환 필드는 목록화되어 있지 않으므로 실제 출력을 기준으로 판단하세요.

사례 2: 채팅에서 실행 시작하기. 상황: 어떤 목표를 즉시 추진해야 한다고 판단하고, 지금 대화에서 그대로 시작하고 싶다. 방법: AgentWorks에게 start runs를 요청합니다. 기대할 수 있는 결과: 실행이 시작되고, 설치된 코딩 에이전트 CLI(Claude Code, Codex, Cursor, Pi, Muse)가 수행을 맡습니다. 이것은 조회가 아니라 실제로 일을 수행하는 행위라는 점에 주의하세요. 실행은 지표 달성까지 계속 작업합니다. 시작 전에 목표와 범위 설정이 올바른지 확인하세요. 실행 수준의 사람 확인 지점은 공식 문서에 없습니다.

사용 경계

읽기/쓰기 성격: MCP가 노출하는 능력에는 읽기(목표 조회, 리포트 읽기)와 실행(실행 시작)이 모두 있습니다. 실행을 시작하면 에이전트가 목표 지표에 도달할 때까지 계속 작업하며 실제 부작용이 있습니다. 각 도구에 읽기 전용 표시가 있는지는 공식적으로 표기되어 있지 않으므로, 모두 읽기 전용이라고 가정하지 마세요.

자격 증명과 로컬 데이터: 첫 실행 시 로컬 워크스페이스 폴더를 선택해야 합니다. AUTH_SECRET은 프로바이더 키를 암호화하는 데 쓰이며, 같은 워크스페이스는 모든 머신에서 같은 값을 재사용해야 합니다. 프로바이더 키를 어떻게 구성하는지는 공식 페이지에 설명이 없습니다.

부작용과 확인 지점: 설치 스크립트는 /Applications와 ~/go/bin에 쓰고, macOS 격리 플래그를 제거하고, 앱을 실행합니다. 실행이 시작되면 에이전트가 계속 수행하며, 단계별 확인 메커니즘이 있는지는 공식 설명에서 찾을 수 없었습니다.

명시적 제한과 미지 항목: 설치 경로는 macOS에서만 확인됩니다. 플랫폼 성격은 source-available이고(저장소 제목 스스로 Open source라고 표기), 라이선스 조건은 저장소를 따릅니다. 비 macOS 플랫폼 지원, MCP 도구의 전체 목록과 매개변수, 원격 호스팅 형태, AUTH_SECRET 외의 인증 방식은 모두 설명이 없으므로, 사용 전에 공식 저장소에서 확인할 것을 권장합니다.