ctx-cloud-setup（ctx 云设置）

Context Mode Cloud Setup

Interactive onboarding flow to connect this plugin to Context Mode Cloud.

Instructions

1. Check existing config — read ~/.context-mode/sync.json using Bash: cat ~/.context-mode/sync.json 2>/dev/null || echo "NOT_FOUND"

- If the file exists and contains a non-empty api_token, inform the user that cloud sync is already configured and show the current api_url and organization_id (never reveal the token — show only the last 4 characters masked as ctx_****abcd). - Ask if they want to reconfigure or keep the current settings. If they want to keep, stop here.

1. Collect configuration — ask the user for three values, one at a time: a) API URL b) API Token c) Organization ID

- Default: https://api.context-mode.com - Tell the user: *"Press Enter to use the default, or paste your self-hosted API URL."* - If the user says "default", use https://api.context-mode.com. - Tell the user: *"Paste your API token from the Context Mode dashboard: Settings > API Tokens."* - This field is required — do not proceed without it. - Validate format: token should start with ctx_ and be at least 20 characters. If invalid, warn and ask again. - Tell the user: *"Paste your Organization ID from the dashboard: Settings > Team."* - This field is required — do not proceed without it.

1. Save config — write the merged config to ~/.context-mode/sync.json using Bash: mkdir -p ~/.context-mode cat > ~/.context-mode/sync.json << 'JSONEOF' {"enabled": true, "api_url": "<API_URL>", "api_token": "<API_TOKEN>", "organization_id": "<ORG_ID>", "batch_size": 50, "flush_interval_ms": 30000} JSONEOF chmod 600 ~/.context-mode/sync.json Replace <API_URL>, <API_TOKEN>, and <ORG_ID> with the collected values.
2. Test the connection — send a health check using Bash: curl -sf -o /dev/null -w "%{http_code}" \ -H "Authorization: Bearer <API_TOKEN>" \ "<API_URL>/api/health"

- 200 = success - Any other code or failure = connection error

1. Display results as markdown directly in the conversation: On success: ` ## context-mode cloud setup - [x] Config saved to ~/.context-mode/sync.json - [x] Connection test: PASS (200 OK) - [x] Organization: <ORG_ID> Cloud sync is now active. Events will be sent to the dashboard on your next Claude Code session. Run /ctx-cloud-status to check sync health at any time. On **failure**: ## context-mode cloud setup - [x] Config saved to ~/.context-mode/sync.json - [] Connection test: FAIL (<error details>) Config was saved but the connection test failed. Check that: 1. Your API URL is reachable 2. Your API token is valid and not expired 3. Your network allows outbound HTTPS Run /ctx-cloud-setup again to reconfigure. `

Security Notes

• Never log or display the full API token. Always mask it.
• Set file permissions to 600 (owner read/write only).
• The token is sent only over HTTPS in the Authorization header.