본문으로 건너뛰기

빠른 시작

이 가이드는 작은 로컬 저장소를 만들고 메모리를 기록·검색한 뒤 간단한 티켓에서 워크플로를 시작합니다.

먼저 설치 가이드에 따라 AideMemo를 설치하고 CLI를 확인합니다.

aidememo --help

1. 데모 저장소 만들기​

export AIDEMEMO_DEMO_STORE="$(mktemp -d)/wiki.sqlite"

아래 명령은 모두 이 저장소를 사용합니다.

am() {
  aidememo --store "$AIDEMEMO_DEMO_STORE" "$@"
}

2. 팩트 추가하기​

결정을 추가합니다.

am fact add \
  "Decision: Redis timeout fixes must go through the Worker job wrapper." \
  --type decision \
  --entities Redis,Worker

교훈을 추가합니다.

am fact add \
  "Lesson: The last Worker Redis timeout was DNS resolution, not pool size." \
  --type lesson \
  --entities Redis,Worker

피해야 할 오류를 추가합니다.

am fact add \
  "Error: Avoid increasing Redis pool size before checking DNS metrics." \
  --type error \
  --entities Redis,Worker

3. 메모리 검색하기​

am search "Redis timeout"

검색 결과와 주변 그래프 컨텍스트가 함께 필요하면 query를 사용합니다.

am query "Fix Redis timeout in worker" --bm25-only --limit 5 --depth 2

4. 티켓에서 워크플로 시작하기​

이슈, PR, 티켓 자동화의 권장 진입점은 workflow start입니다. 추적 세션을 만들고 티켓을 저장한 뒤 이전 결정, 교훈, 오류, 검색 결과를 반환합니다.

am workflow start "Fix Redis timeout in worker" \
  --body "Worker jobs intermittently time out against Redis." \
  --source "github:org/app#123" \
  --bm25-only

출력에는 다음 필드가 포함됩니다.

  • session_id: 이후 팩트를 이 작업에 연결합니다.
  • ticket_fact_id: 저장된 입력 티켓 팩트입니다.
  • relevant_decisions: 작업을 이끌어야 하는 결정입니다.
  • prior_lessons: 유사 작업에서 얻은 교훈입니다.
  • prior_errors: 피해야 할 알려진 실패 패턴입니다.

5. 세션 이어가기​

CLI가 출력한 export 명령을 사용하면 이후 fact add 호출이 활성 워크플로 세션에 연결됩니다.

export AIDEMEMO_SESSION_ID=session-...

am fact add \
  "Lesson: This timeout was caused by a missing DNS retry around the worker wrapper." \
  --type lesson \
  --entities Redis,Worker

6. 최근 메모리 확인하기​

am recent --last 1d
am stats

7. 추적 세션 핸드오프​

Handoff는 현재 아직 릴리스되지 않은 main 기능입니다. 공개 v0.1.0 바이너리에는 이 명령이 없습니다. 이 절을 진행하기 전에 현재 체크아웃에서 cargo install --path crates/aidememo-cli로 CLI를 빌드하세요.

반복해서 사용하는 Codex 또는 Claude 계정은 한 번만 등록합니다. 프로필에는 경로와 라우팅 메타데이터만 저장되며 자격 증명은 저장되지 않습니다.

am agent add codex-two --type codex \
  --home /path/to/codex-two-home \
  --workspace "$PWD"

활성 세션을 보냅니다. 목적지 프로필에서 런타임과 기본 source 범위를 가져옵니다.

export AIDEMEMO_ACTOR_ID=codex-one

am handoff send codex-two \
  --focus "Redis timeout 패치 검토" \
  --done-when "집중 테스트를 통과하고 검토 결과를 기록"

해당 계정의 가장 오래된 pending 작업을 실행하고 send가 출력한 ID로 반환 결과를 확인합니다.

am handoff run codex-two
am handoff show handoff-...
am handoff board --stale-after 1h --include-completed

이것으로 자동 왕복이 끝납니다. 발신자가 다음 목표를 명시하고, 수신 계정이 같은 세션을 이어서 작업하며, 반환 결과도 그 세션에 연결됩니다. 수동 수신자, identity 필드, timeout, heartbeat, Hermes 경계는 추적 작업 핸드오프에서 이어서 확인하세요.

이제 CLI, MCP, SDK에서 사용할 수 있는 로컬 메모리 저장소가 준비됐습니다.