@atollhq/skill-codex 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-codex",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Install the Atoll project management integration for Codex CLI",
   "bin": {
     "skill-codex": "./bin/install.mjs"

package/skill/SKILL.md

@@ -28,34 +28,61 @@ All requests require: `Authorization: Bearer sk_atoll_<key>`
 
 Verify with: `GET /api/auth/me`
 
-API keys are generated in **Settings > Members > Add Agent**. Store as `$ATOLL_API_KEY`.
+API keys are generated in **Settings > Members > Add Agent** (for agents) or **Settings > Members > Create API Key** (for integrations). Store as `$ATOLL_API_KEY`.
 
-## Quick Start
+## Quick Start — CLI (recommended)
+
+Install globally or use via npx:
 
 ```bash
-export ATOLL_API_KEY="sk_atoll_..."
+npm install -g @atollhq/cli   # or: npx atoll ...
+```
 
-# Helper function
-atoll() {
-  curl -s -H "Authorization: Bearer $ATOLL_API_KEY" \
-       -H "Content-Type: application/json" \
-       "https://atollhq.com$1" "${@:2}" | python3 -m json.tool
-}
+Configure once:
+
+```bash
+atoll auth login --key sk_atoll_...
+atoll config set-org my-org
+```
 
-# List orgs
-atoll /api/orgs
+Common commands:
 
+```bash
 # List tasks
-atoll "/api/orgs/{orgId}/issues?projectId={projectId}"
+atoll issue list
+atoll issue list --status todo --priority 1
+
+# View a task
+atoll issue view ATOLL-42
 
 # Create a task
-atoll /api/orgs/{orgId}/issues -X POST -d '{"title":"Fix login bug","status":"todo","priority":1}'
+atoll issue create --title "Fix login bug" --status todo --priority 1
 
 # Update a task
-atoll /api/orgs/{orgId}/issues/{issueId} -X PATCH -d '{"status":"in_progress"}'
+atoll issue update ATOLL-42 --status in_progress
+
+# Assign a task
+atoll issue assign ATOLL-42 --to <user-id>
+atoll issue assign ATOLL-42 --to self
+
+# Comments
+atoll comment add ATOLL-42 --body "Working on this now"
 
-# Add a comment
-atoll /api/orgs/{orgId}/issues/{issueId}/comments -X POST -d '{"body":"Working on this now"}'
+# Projects & milestones
+atoll project list
+atoll milestone list --project <project-id>
+```
+
+## Quick Start — API (for advanced use)
+
+All CLI commands map to REST endpoints. Use the API directly when the CLI doesn't cover a specific operation.
+
+```bash
+export ATOLL_API_KEY="sk_atoll_..."
+
+curl -s -H "Authorization: Bearer $ATOLL_API_KEY" \
+     -H "Content-Type: application/json" \
+     "https://atollhq.com/api/orgs/{orgId}/issues?status=todo"
 ```
 
 ## The Heartbeat Loop
@@ -81,10 +108,12 @@ Signal types: `kpi_off_pace`, `kpi_stale`, `issue_stale`, `issue_blocked`, `mile
 
 ### Pick up and complete a task
 
-1. `GET /api/orgs/{id}/issues?status=todo&assigneeId={agentId}` -- find assigned work
-2. `PATCH /api/orgs/{id}/issues/{issueId}` with `{"status":"in_progress"}` -- start work
-3. `POST /api/orgs/{id}/issues/{issueId}/comments` with `{"body":"Progress update..."}` -- report progress
-4. `PATCH /api/orgs/{id}/issues/{issueId}` with `{"status":"done"}` -- complete
+```bash
+atoll issue list --status todo --assignee self        # find assigned work
+atoll issue update ATOLL-42 --status in_progress      # start work
+atoll comment add ATOLL-42 --body "Progress update…"  # report progress
+atoll issue update ATOLL-42 --status done              # complete
+```
 
 ### Set up the strategy chain
 

package/skill/references/api-endpoints.md

@@ -38,6 +38,7 @@ All endpoints require `Authorization: Bearer sk_atoll_...` header.
 - [Webhooks](#webhooks)
 - [Notifications](#notifications)
 - [Agents](#agents)
+- [Integrations](#integrations)
 - [GitHub Integration](#github-integration)
 
 ---
@@ -377,6 +378,17 @@ URL must be HTTPS. Returns webhook record plus `secret` for HMAC verification.
 | POST | `/api/orgs/{id}/agents/{agentId}/rotate` | Rotate all keys |
 | POST | `/api/orgs/{id}/agents/{agentId}/install-snippets` | Get install snippets (`{ key }`) |
 
+## Integrations
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/orgs/{id}/integrations` | List integrations (owner/admin) |
+| POST | `/api/orgs/{id}/integrations` | Create integration (`{ name }`) |
+| DELETE | `/api/orgs/{id}/integrations/{integrationId}` | Revoke integration |
+| GET | `/api/orgs/{id}/integrations/{integrationId}/keys` | List API keys |
+| POST | `/api/orgs/{id}/integrations/{integrationId}/keys` | Generate new key (`{ name? }`) |
+| DELETE | `/api/orgs/{id}/integrations/{integrationId}/keys/{keyId}` | Revoke key |
+
 ## GitHub Integration
 
 | Method | Endpoint | Description |