Onboarding — First-Time Aicoo Setup

Guide users through API key setup, workspace init, and first knowledge sync.

Phase 1: API Key

1. Go to https://www.aicoo.io/settings/api-keys
2. Generate token
3. Export env var:

export AICOO_API_KEY=aicoo_sk_live_xxxxxxxx

Verify:

curl -s -X POST "https://www.aicoo.io/api/v1/init" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .

Phase 2: Initialize + inspect

curl -s -X POST "https://www.aicoo.io/api/v1/init" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .

curl -s "https://www.aicoo.io/api/v1/os/status" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .

Phase 3: Discover user context

Ask:

• role/background
• current projects
• what the agent should share
• what the agent must not share
• who will talk to the agent

Scan local docs (README.md, docs/, project notes) to collect source material.

Phase 4: Create first core note

Use OS endpoint (post-refactor):

curl -s -X POST "https://www.aicoo.io/api/v1/os/notes" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title":"About Me",
    "content":"# [User Name]\n\n## Role\n...\n\n## Current Work\n...\n\n## Boundaries\n..."
  }' | jq .

Phase 5: Sync local files

CONTENT=$(cat path/to/file.md)

curl -s -X POST "https://www.aicoo.io/api/v1/accumulate" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg path "Technical/architecture.md" --arg content "$CONTENT" '{files:[{path:$path,content:$content}]}')" | jq .

Phase 6: Identity files (memory/self/)

Initialize:

• memory/self/COO.md
• memory/self/USER.md
• memory/self/POLICY.md

via /accumulate.

Phase 7: Create first share link

curl -s -X POST "https://www.aicoo.io/api/v1/os/share" \
  -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"scope":"all","access":"read","notesAccess":"read","label":"First share link","expiresIn":"7d","requireSignIn":true}' | jq .

API Split Reminder

• /api/v1/os/* => workspace-native operations
• /api/v1/tools => non-OS tools only (namespace field in catalog)