@atollhq/skill-codex 0.1.10 → 0.1.11

package/README.md

@@ -31,7 +31,6 @@ Once installed, ask Codex anything task-related:
 "List my Atoll tasks"
 "Create an issue to fix the login bug, priority 1"
 "What goals are off pace?"
-"Check my Atoll heartbeat"
 "Move ATOLL-42 to in_progress"
 ```
 
@@ -41,27 +40,19 @@ For terminal-first work, see [`@atollhq/cli`](https://www.npmjs.com/package/@ato
 
 ```bash
 npm install -g @atollhq/cli
-atoll auth login --key sk_atoll_...
-atoll config set-org your-org-slug
-atoll heartbeat
-atoll issue list --json
-atoll agent-context
+atoll auth setup
+atoll issue list
 ```
 
 For multiple agents or orgs, use CLI auth profiles:
 
 ```bash
-atoll auth login --profile agent-a --key sk_atoll_... --org acme
+atoll auth manage
+atoll auth profiles
+atoll auth login --profile agent-a --key sk_atoll_... --org acme --project project-uuid
 atoll auth login --profile agent-b --key sk_atoll_... --org client
 atoll --profile agent-b issue list
-```
-
-The companion CLI also supports safer issue removal and local/upstream feedback:
-
-```bash
-atoll issue archive ATOLL-42
-atoll issue delete ATOLL-42 --dry-run
-atoll feedback "The heartbeat output should include blocked issue details"
+atoll auth delete-profile agent-b --force
 ```
 
 ## License

package/package.json

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

package/skill/SKILL.md

@@ -56,42 +56,45 @@ npm install -g @atollhq/cli   # or: npx @atollhq/cli ...
 Configure once:
 
 ```bash
-atoll auth login --key sk_atoll_...
-atoll config set-org my-org
+atoll auth setup
+
+# Or configure non-interactively:
+atoll auth login --key sk_atoll_... --org my-org
 ```
 
 For machines or agents that need multiple credentials, use auth profiles:
 
 ```bash
-atoll auth login --profile agent-a --key sk_atoll_... --org acme
-atoll auth login --profile agent-b --key sk_atoll_... --org client
+atoll auth setup
+atoll auth manage
 atoll auth profiles
 atoll auth use agent-a
 
+# Non-interactive profile setup can include default org/project context
+atoll auth login --profile agent-a --key sk_atoll_... --org acme --project project-uuid
+atoll auth login --profile agent-b --key sk_atoll_... --org client
+
 # Run one command as a specific profile
 atoll --profile agent-b issue list
+
+# Remove an obsolete profile
+atoll auth delete-profile agent-b --force
 ```
 
 Common commands:
 
 ```bash
-# Agent orientation
-atoll heartbeat
-atoll heartbeat --signals-only
-atoll heartbeat --severity critical
-atoll heartbeat --json
-atoll agent-context
-
 # List tasks
-atoll issue list --json
-atoll issue list --status todo --priority 1 --limit 25
+atoll issue list
+atoll issue list --project <project-id>
+atoll issue list --status todo --priority 1
 
 # View a task
-atoll issue get ATOLL-42
-atoll issue view ATOLL-42   # alias kept for humans
+atoll issue view ATOLL-42
 
 # Create a task
 atoll issue create --title "Fix login bug" --status todo --priority 1
+atoll issue create --title "Fix login bug" --project <project-id>
 
 # Update a task
 atoll issue update ATOLL-42 --status in_progress
@@ -103,28 +106,15 @@ atoll issue assign ATOLL-42 --to self
 # Comments
 atoll comment add ATOLL-42 --body "Working on this now"
 
-# Safe removal
-atoll issue archive ATOLL-42
-atoll issue unarchive ATOLL-42
-atoll issue delete ATOLL-42 --dry-run
-atoll issue delete ATOLL-42 --force
-
-# Report friction to Atoll maintainers
-atoll feedback "The status error should list custom board statuses"
-
 # Projects & milestones
 atoll project list
+atoll config set-project <project-id>   # optional default for issue/milestone commands
 atoll milestone list --project <project-id>
+atoll milestone list                    # uses the default project when configured
 ```
 
-Prefer the CLI for routine task operations, heartbeat checks, comments, and feedback. Use direct API calls when the CLI does not expose the needed endpoint yet.
-
-CLI JSON conventions:
-
-- Use `--json` for machine-readable output.
-- List commands return `{ resource, items, total, limit, offset, nextOffset, truncated, hint }`.
-- Diagnostics and errors go to stderr.
-- `atoll agent-context` returns a versioned command/flag manifest and available profile context.
+Profiles can store a default project ID. Explicit `--project` flags override it, and
+`ATOLL_PROJECT` overrides profile config for one process.
 
 ## Quick Start — API (for advanced use)
 
@@ -145,7 +135,7 @@ atoll "/api/orgs/$ATOLL_ORG_ID/issues?status=todo"
 
 ## The Heartbeat Loop
 
-The primary pattern for autonomous agents. Prefer `atoll heartbeat --json` when the CLI is available; it wraps `GET /api/orgs/{id}/heartbeat` and returns the same computed briefing:
+The primary pattern for autonomous agents. `GET /api/orgs/{id}/heartbeat` returns a computed briefing:
 
 - **Goal status** with days remaining
 - **KPI pace**: `pace_needed` vs `pace_actual`, trend (`accelerating`/`decelerating`/`flat`), staleness
@@ -155,15 +145,6 @@ The primary pattern for autonomous agents. Prefer `atoll heartbeat --json` when
 
 Signal types: `kpi_off_pace`, `kpi_stale`, `issue_stale`, `issue_blocked`, `milestone_overdue`, `initiative_stalled`, `webhook_failing`. Severity: `info`, `warning`, `critical`.
 
-Useful CLI forms:
-
-```bash
-atoll heartbeat
-atoll heartbeat --signals-only
-atoll heartbeat --severity critical
-atoll heartbeat --json
-```
-
 **The agent loop:**
 1. Call heartbeat
 2. Read signals (highest severity first)
@@ -176,8 +157,7 @@ atoll heartbeat --json
 ### Pick up and complete a task
 
 ```bash
-atoll heartbeat --signals-only                        # orient first
-atoll issue list --status todo --assignee self --json # find assigned work
+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
@@ -226,7 +206,7 @@ Full endpoint tables and field schemas:
 
 All endpoints are under `/api/orgs/{orgId}/...`.
 
-† `DELETE /issues/{id}` requires `owner` or `admin` role — any caller without that role (including member-role agents) gets `403`. If you just need to remove a task, use `POST /api/orgs/{orgId}/issues/{issueId}/archive` (soft delete, no role gate); reverse with `DELETE` on the same path (unarchive). In the CLI, prefer `atoll issue archive <id>`. Permanent `atoll issue delete <id>` requires `--force` and supports `--dry-run`.
+† `DELETE /issues/{id}` requires `owner` or `admin` role — any caller without that role (including member-role agents) gets `403`. If you just need to remove a task, use `POST /api/orgs/{orgId}/issues/{issueId}/archive` (soft delete, no role gate); reverse with `DELETE` on the same path (unarchive).
 
 ### Quick enum reference
 
@@ -262,14 +242,6 @@ curl -X POST https://atollhq.com/api/feedback \
 
 No authentication required. Use this when you encounter unexpected API errors, missing functionality, or have suggestions for the platform.
 
-The CLI can record the same feedback locally, and optionally submit upstream:
-
-```bash
-atoll feedback "The /issues endpoint returns 500 when filtering by milestoneId and status together"
-atoll feedback --send "heartbeat should emit issue_blocked signals directly"
-atoll feedback list --json
-```
-
 ## Notes
 
 - Request bodies accept camelCase; responses use snake_case

package/skill/references/api-endpoints.md

@@ -231,14 +231,6 @@ Returns computed briefing with goal status, KPI pace/trend, initiative progress,
 
 Signal types: `kpi_off_pace`, `kpi_stale`, `issue_stale`, `issue_blocked`, `milestone_overdue`, `initiative_stalled`, `webhook_failing`. Severity: `info`, `warning`, `critical`.
 
-CLI equivalent:
-
-```bash
-atoll heartbeat --json
-atoll heartbeat --signals-only
-atoll heartbeat --severity critical
-```
-
 ## Activity
 
 | Method | Endpoint | Description |
@@ -254,6 +246,8 @@ Filters: `by_me` = your actions; `mine` = activity on issues assigned to you.
 |--------|----------|-------------|
 | GET | `/api/orgs/{id}/teams` | List teams |
 | POST | `/api/orgs/{id}/teams` | Create team |
+| PATCH | `/api/orgs/{id}/teams/{teamId}` | Update team (`{ name?, slug?, description? }`) |
+| DELETE | `/api/orgs/{id}/teams/{teamId}` | Delete team |
 | GET | `/api/orgs/{id}/teams/{teamId}/members` | List team members |
 | POST | `/api/orgs/{id}/teams/{teamId}/members` | Add member to team |
 | DELETE | `/api/orgs/{id}/teams/{teamId}/members/{memberId}` | Remove from team |
@@ -427,11 +421,3 @@ No authentication required. Sends feedback to the Atoll team's internal board.
 | Method | Endpoint | Description |
 |--------|----------|-------------|
 | POST | `/api/feedback` | Submit bug report or feature request (`{ type, description, userEmail?, userName?, url? }`)
-
-CLI equivalent:
-
-```bash
-atoll feedback "Describe the bug or feature request"
-atoll feedback --send "Submit upstream as well"
-atoll feedback list --json
-```