OA
OpenAkashic
Remote Agent Enrollment
///

Remote Agent Enrollment

When a new server or agent instance joins, give it the same Closed Akashic MCP endpoint, the same token environment variable, and the same project-index workflow so memory stays shared instead of drifting.

///

Summary#

When a new server or agent instance joins, give it the same Closed Akashic MCP endpoint, the same token environment variable, and the same project-index workflow so memory stays shared instead of drifting.

Enrollment Checklist#

  1. Set CLOSED_AKASHIC_TOKEN on that server.
  2. Register https://knowledge.openakashic.com/mcp/ in the agent client.
  3. Create or update the host-level ~/.codex/AGENTS.md from Codex AGENTS Template.
  4. Smoke-test retrieval with search_notes and read_note.
  5. Smoke-test write access with append_note_section or upsert_note.
  6. If the project is new, create its README index and initial project folders with bootstrap_project.
  1. Search the project name.
  2. Read the project README.
  3. Append a short dated section to a safe operations note or create a tiny temporary test note.
  4. Confirm the note is visible in the browser surface and retrievable over MCP.
  5. If any step fails, inspect MCP Debugging and Logs.

Project Enrollment#

Use bootstrap_project when the project has no README yet.

Recommended inputs: - project: <scope>/<project>, for example personal/openakashic, company/acme, research/llm-notes, or ops/aws - title: human-readable project title - summary: one-line description of what belongs in that workspace - canonical_docs: repo doc paths or URLs - folders: optional project-specific folder list when the defaults are not right

Reuse#

This playbook is the default way to attach a new server, not a special case. If a new machine can follow these steps and retrieve the same note graph, the memory system is behaving correctly.

Claude Code Enrollment#

Claude Code는 프로젝트 루트의 CLAUDE.md를 매 세션 시작 시 자동 로드한다. Codex의 AGENTS.md, Cursor의 .cursor/rules/*.mdc와 동등.

Claude Code 추가 단계#

  1. MCP 엔드포인트를 ~/.claude.json (또는 프로젝트 스코프 mcpServers)에 등록한다. json { "type": "http", "url": "https://knowledge.openakashic.com/mcp/", "headers": { "Authorization": "Bearer <TOKEN>" } }
  2. 프로젝트 루트에 CLAUDE.md를 생성한다 — 템플릿은 Claude Code CLAUDE.md Template 참조.
  3. Smoke-test: 세션에서 list_folders → search_notes → append_note_section 순으로 호출해 읽기/쓰기 모두 확인.
  4. 기존 Enrollment Checklist의 4~6번(Smoke-test, Project Enrollment)은 동일하게 적용.

기존 에이전트와의 정합성#

  • CLAUDE.md의 핵심 규칙(메모리 검색→작업→write-back, 도커 배포→검증)은 Codex AGENTS.md / Cursor .mdc와 일치시킨다.
  • 하나가 바뀌면 나머지도 함께 갱신해야 drift가 안 생긴다.
  • 갱신 체크리스트: ~/.codex/AGENTS.md + 프로젝트 AGENTS.md + .cursor/rules/closed-akashic-mcp.mdc + CLAUDE.md

발견 경위#

2026-04-16 arc-fleet 세션에서 Claude Code가 MCP 연결은 됐지만 행동 지침 누락으로 배포 검증·메모리 write-back·사전 검색을 모두 건너뛴 것을 확인. Codex/Cursor와 달리 Claude Code의 enrollment 단계가 플레이북에 없었음이 원인.