APX 1.36.0 — APC를 기반으로 구축된 AI 에이전트를 위한 로컬 런타임 (Local Runtime)

APX가 방금 1.36.0 버전을 출시했습니다. 아직 접해보지 못하셨다면: APX는 APC 프로토콜을 위한 레퍼런스 런타임 (reference runtime)입니다. 이는 로컬 데몬 (local daemon), CLI, 그리고 웹 관리자 (web admin)로 구성되어 있으며, 여러분이 그날 어떤 코딩 도구를 사용하든 상관없이 **하나의 휴대 가능한 프로젝트 컨텍스트 (portable project context)**를 대상으로 AI 에이전트를 실행할 수 있게 해줍니다.

이 글은 APX 1.36.0 버전의 기능과 최근 릴리스가 도달한 지점에 대한 빠른 안내서입니다.

하나의 아이디어

프로젝트 컨텍스트 (Project context)를 매번 모든 도구에 다시 설명할 필요가 없어야 합니다. 한 번 작성하여 저장소 (repo)에 커밋하면, 어떤 런타임 (runtime)이든 동일한 내용을 읽게 됩니다.

APX는 이 분리에 대해 명확한 기준을 가지고 있습니다:

• 저장소에 커밋됨 (.apc/) — 에이전트 정의 (agent definitions), 프로젝트 메타데이터 (project metadata), MCP 힌트 (MCP hints), 스킬 (skills), 그리고 큐레이션된 메모리 (curated memory).
• 머신 로컬에 저장됨 (~/.apx/) — 세션 (sessions), 대화 (conversations), 메시지 로그 (message logs), 그리고 캐시 (caches). 절대 커밋되지 않습니다.

파일 시스템이 신뢰할 수 있는 단일 원천 (source of truth)입니다. 특정 벤더의 데이터베이스도, 숨겨진 상태 (hidden state)도, 종속성 (lock-in)도 없습니다.

실제로 실행하는 것

npm install -g apx
apx setup        # provider -> model -> channels -> daemon
apx init         # AGENTS.md가 있는 모든 폴더를 등록

그다음부터는:

• apx run sofia --runtime claude-code "Review the open PRs" — 작업을 완전한 외부 런타임 (Claude Code, Codex, OpenCode, Aider, Cursor Agent)에 전달합니다. 만약 하나가 설치되어 있지 않으면, APX는 다른 것으로 대체합니다.
• apx exec sofia "What is my role here?" — Anthropic, OpenAI, Gemini, 또는 로컬 Ollama 모델을 통해 Anthropic, OpenAI, Gemini 또는 로컬 Ollama 모델을 통한 빠른 원샷 (one-shot) LLM 호출을 수행합니다.
• apx messages tail — 모든 채널을 실시간으로 모니터링합니다.

어떤 런타임이나 엔진을 선택하든 동일한 컨텍스트 (context)와 동일한 메모리 (memory)를 사용합니다.

세 가지 인터페이스, 하나의 데몬

• CLI — 에이전트 실행 (run agents), 메모리 읽기 (read memory), 메시지 테일링 (tail messages), 세션 관리 (manage sessions).
• Web admin — localhost:7430에서 브라우저를 통해 동일한 런타임 (runtime)을 사용합니다. 프로젝트, 에이전트, 세션, MCP, 엔진, 채널을 탐색할 수 있습니다. 이는 로컬 데몬 (local daemon)과만 통신합니다.
• Telegram — 휴대폰에서 프로젝트 에이전트를 조작합니다. 역할 (roles) 기반의 신원 확인을 통해 권한을 제어하며, 모든 메시지는 완전한 감사 추적 (audit trail)을 위해 채널별로 기록됩니다.

최근 릴리스에서 추가된 사항

최근 몇 차례의 업데이트는 일상적인 런타임 (runtime) 사용 환경을 개선하는 데 중점을 두었습니다.

• 1.34 — 변수 (Variables). 프로젝트별 및 전역 변수 관리를 지원하여, 설정 (config)을 매번 복사하여 붙여넣는 번거로움을 없앴습니다.
• 1.35 — 스킬 인스펙터 (Skill Inspector). 선택 사항 (opt-in)으로 제공되는 턴 단위 미들웨어 (middleware)로, 모든 것을 미리 로드하는 대신 해당 턴에 필요한 적절한 스킬 (skill)만 불러옵니다.
• 1.36 — 채널을 통한 대화 (Conversations with channels) + 요약 (summaries). 대화 관리 기능이 이제 채널을 이해하고 스레드 (threads)를 요약할 수 있어, 장기간 지속되는 에이전트 채팅을 읽기 쉽게 유지해 줍니다.

이 중 어떤 것도 기본 계약 (contract)을 변경하지 않습니다: 컨텍스트 (context)는 레포지토리 (repo)에 머물고, 런타임 상태 (runtime state)는 로컬에 머뭅니다.

왜 사용하는가

솔직한 제안은 의도적으로 지루하게 구성되었습니다. APX는 새로운 IDE나 새로운 모델이 되려고 시도하지 않습니다. APX는 이미 사용 중인 도구들 전반에서 하나의 프로젝트 컨텍스트 (project context)를 사용할 수 있게 만드는 배관 (plumbing) 역할을 하며, 비밀 정보 (secrets)와 머신 상태 (machine state)는 마땅히 있어야 할 곳인 런타임 저장소 (runtime storage)에 보관됩니다.

이미 AGENTS.md 파일이 있다면, 이미 목표의 대부분에 도달한 것입니다.

npm install -g apx

• Repo: https://github.com/agentprojectcontext/apx
• Site: https://agentprojectcontext.github.io/apx/
• Protocol: https://github.com/agentprojectcontext/agentprojectcontext