RTMX
RTMX Sync를 위한 오픈 소스 클라이언트 — 인간과 에이전트에게 Git 다음을 제시합니다.
CI
Coverage Status
Go Report Card
License
RTMX workflow
Git은 파일을 버전 관리했습니다. Sync는 공간입니다. 인간과 에이전트가 작업을 주장하고, 수렴하며, 배포하는 라이브 매트릭스(live matrix of intent)입니다. 이 저장소는 아파치 2.0 (Apache 2.0) CLI 및 MCP 인터페이스이며 — 그 공간에 진입하는 방법입니다. 로컬 CSV-in-git 방식은 여전히 오프라인에서 작동하지만, 팀이 라이브 상태를 유지하는 방법은 Sync입니다.
Sync 탐색하기 → ·
요금제 ·
배경 이야기 읽기
설치 (Install)
brew install rtmx-ai/tap/rtmx
scoop install rtmx
go install github.com/rtmx-ai/rtmx/cmd/rtmx@latest
또는 릴리스(releases)에서 바이너리를 다운로드하세요.
자가 호스팅 (Self-hosted): rtmx sync --sync-url sync.example.com/sync/acme/main (클라이언트는 wss://를 추가합니다).
기능 (What It Does)
| 명령어 | 기능 |
|---|
rtmx sync | Sync 공간에 참여합니다 (호스팅 또는 자체 관리). |
| ... | |
33개의 명령어가 있습니다. 전체 목록은 rtmx --help를 실행하세요. | |
RTMX commands
AI 워크플로우 (The AI Workflow)
flowchart TD
A[
- PR에서 **인간이 읽기 쉬운 변경 사항(Human-readable diffs)** 제공 -- 한 줄 변경, 하나의 요구사항 완료
- **어디서든 작동** -- 오프라인, 에어갭 환경, 데이터베이스 불필요, API 불필요
- **AI 에이전트가 SDK 없이 파싱** -- 그냥 파일임
- **git blame**을 사용하면 모든 요구사항이 언제, 왜 변경되었는지 알 수 있음
- **벤더 종속성 없음(No vendor lock-in)** -- 당신의 레포지토리 내 데이터임
## MCP 통합 (MCP Integration)
```mermaid
flowchart LR
subgraph agents["AI 에이전트"]
direction TB
...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Spine 도구(상태/백로그/다음 작업/요청/클레임 등)와 과학적 순환 표면(loop_tick, decompose, hygiene, cycles, webs, context, delivery_check, trade_*)을 결합합니다. 임의의 CLI를 실행하는 것보다 이 도구들을 선호하세요. 일반적인 run_cli 도구는 없습니다. 변경 사항은 agent_id가 필요합니다.
MCP를 통한 에이전트 세션(next → claim → status). 아래에 일회성 클라이언트 설정이 있습니다. GIF는 사람이 mcp.json을 검사하는 것이 아니라, 에이전트가 도구를 호출하는 장면입니다.
RTMX MCP agent session
Cursor의 경우 — 한 번만 .cursor/mcp.json에 추가하면 됩니다 (그러면 에이전트가 도구를 사용합니다):
{"mcpServers":{"rtmx":{"command":"rtmx","args":["mcp-server","--stdio"]}}}
Claude Code의 경우 — 한 번만 실행하면 됩니다:
claude mcp add rtmx -- rtmx mcp-server --stdio
테스트 검증 (Test Verification)
rtmx verify는 사용자의 테스트 프레임워크를 자동으로 감지합니다. 설정이 필요 없습니다.
Go, Python/pytest, Rust/Cargo, Node.js/npm, Java/Gradle, Java/Maven, Elixir/Mix, Swift, Dart, Ruby 등 10개 이상의 프레임워크를 지원합니다.
자체 테스트 (Dogfooding)
RTMX는 자체 요구사항을 관리합니다. 24개 단계에 걸쳐 219개의 요구사항이 있으며, 푸시할 때마다 CI에서 자동 검증됩니다. 이 레포지토리에서 rtmx status를 실행하여 확인할 수 있습니다.
배경 이야기 읽기 -- 이 도구가 어떻게, 왜 만들어졌는지에 대한 내용입니다.
벤치마크 결과 (Benchmark Results)
intent-bench가 독립적으로 테스트하여 코딩 에이전트에게 구조화된 요구사항을 제공하는 것이 구현 효과성을 개선하는지 측정했습니다. Claude Sonnet 4를 사용한 N=5회 실행 조건별 결과는 다음과 같습니다:
| 실험 (Experiment) | 복잡도 (Complexity) | 제어군 (Control) | 처리군 (Treatment, RTMX) | Fisher p |
|---|
| url-shortener | Baseline (10 요청) | 100% 완료 | 80% 완료 | 1.000 |
| task-manager | Standard (13 요청, 깊이 5) | 20% 완료 | 80% 완료 | 0.206 |
Baseline 작업에서는 의도 계층(intent layer)을 추가해도 완료율이 개선되지 않고 오버헤드만 발생합니다. 복잡한 종속성 체인(dependency chains)을 가진 표준 작업의 경우, 완료율이 20%에서 80%로 증가하고 토큰 분산(token variance)은 감소합니다 (CV 0.85 $
ightarrow$ 0.46).
전체 데이터, 방법론 및 재현 지침:
intent-bench.github.io/intent-bench
기술 상세 (Technical Details)
- 단일 정적 바이너리 -- Go,
CGO_ENABLED=0, 런타임 종속성 없음
- Linux, macOS, Windows -- amd64 및 arm64 지원
- 외부 종속성 2개 (Cobra + YAML 파서)
- SBOM이 포함된 GPG 서명 릴리스 제공
- Apache 2.0 라이선스
기여 (Contributing)
development setup, 빌드 및 테스트 지침은 CONTRIBUTING.md를 참조하십시오.
Python CLI에서 마이그레이션하기
사용 중단 알림(Deprecation Notice): Python rtmx CLI는 사용이 중단되었으며 2026-09-25에 지원 종료됩니다. pip uninstall rtmx를 실행하고 위의 Go 바이너리로 전환하십시오.
전체 마이그레이션 단계는 docs/MIGRATION.md를 참조하십시오.
지원 (Support)