@atollhq/skill-claude 0.1.9 → 0.1.11

package/README.md

@@ -7,17 +7,19 @@ Gives your Claude Code agent the ability to manage tasks, goals, KPIs, initiativ
 ## Install
 
 ```bash
-npx @atollhq/skill-claude --key sk_atoll_... --org your-org-id
+npx @atollhq/skill-claude --key sk_atoll_... --org your-org-id --project project-id --team team-id
 # or
 ATOLL_API_KEY=sk_atoll_... ATOLL_ORG_ID=your-org-id npx @atollhq/skill-claude
 ```
 
+Optional defaults: `--project`, `--team`, and `--base-url` write `ATOLL_PROJECT`, `ATOLL_TEAM`, and `ATOLL_BASE_URL` for the agent.
+
 Get an API key from **Settings > Members > Add Agent** (or **Create API Key** for integrations) in the Atoll app.
 
 This does two things:
 
 1. Copies the skill into `~/.claude/skills/atoll-api/`
-2. Writes `ATOLL_API_KEY` and `ATOLL_ORG_ID` into `~/.claude/settings.json` under `env`
+2. Writes Atoll env vars into `~/.claude/settings.json` under `env`
 
 Restart Claude Code and the `atoll-api` skill is available.
 
@@ -41,8 +43,7 @@ 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 auth login --profile agent-a --key sk_atoll_... --org your-org-slug --project project-id --team team-id
 atoll heartbeat
 atoll issue list --json
 atoll agent-context
@@ -52,7 +53,7 @@ For multiple agents or orgs, use CLI 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 login --profile agent-b --key sk_atoll_... --org client --project project-id --team team-id
 atoll --profile agent-b issue list
 ```
 

package/bin/install.mjs

@@ -14,6 +14,12 @@ function parseArgs(argv) {
       args.key = argv[++i]
     } else if (argv[i] === '--org' && argv[i + 1]) {
       args.org = argv[++i]
+    } else if (argv[i] === '--project' && argv[i + 1]) {
+      args.project = argv[++i]
+    } else if (argv[i] === '--team' && argv[i + 1]) {
+      args.team = argv[++i]
+    } else if (argv[i] === '--base-url' && argv[i + 1]) {
+      args.baseUrl = argv[++i]
     } else if (argv[i] === '--help' || argv[i] === '-h') {
       args.help = true
     }
@@ -23,13 +29,16 @@ function parseArgs(argv) {
 
 function printUsage() {
   console.log(`
-Usage: npx @atollhq/skill-claude --key <api-key> --org <org-id>
+Usage: npx @atollhq/skill-claude --key <api-key> --org <org-id> [--project <id>] [--team <id-or-slug>] [--base-url <url>]
    or: ATOLL_API_KEY=<api-key> ATOLL_ORG_ID=<org-id> npx @atollhq/skill-claude
 
 Options:
-  --key   Atoll API key (sk_atoll_...). Defaults to ATOLL_API_KEY.
-  --org   Organization ID. Defaults to ATOLL_ORG_ID.
-  --help  Show this help message
+  --key       Atoll API key (sk_atoll_...). Defaults to ATOLL_API_KEY.
+  --org       Organization ID. Defaults to ATOLL_ORG_ID.
+  --project   Default project ID. Defaults to ATOLL_PROJECT.
+  --team      Default team ID or slug. Defaults to ATOLL_TEAM.
+  --base-url  Atoll base URL. Defaults to ATOLL_BASE_URL.
+  --help      Show this help message
 
 This installs the Atoll skill for Claude Code, giving your agent
 the ability to manage tasks, goals, KPIs, and initiatives.
@@ -39,6 +48,9 @@ the ability to manage tasks, goals, KPIs, and initiatives.
 const args = parseArgs(process.argv)
 args.key ??= process.env.ATOLL_API_KEY
 args.org ??= process.env.ATOLL_ORG_ID
+args.project ??= process.env.ATOLL_PROJECT
+args.team ??= process.env.ATOLL_TEAM
+args.baseUrl ??= process.env.ATOLL_BASE_URL
 
 if (args.help) {
   printUsage()
@@ -79,9 +91,16 @@ if (existsSync(settingsPath)) {
 if (!settings.env) settings.env = {}
 settings.env.ATOLL_API_KEY = args.key
 settings.env.ATOLL_ORG_ID = args.org
+if (args.project) settings.env.ATOLL_PROJECT = args.project
+if (args.team) settings.env.ATOLL_TEAM = args.team
+if (args.baseUrl) settings.env.ATOLL_BASE_URL = args.baseUrl
 
 writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n')
-console.log(`Configured ATOLL_API_KEY and ATOLL_ORG_ID in ${settingsPath}`)
+const configuredVars = ['ATOLL_API_KEY', 'ATOLL_ORG_ID']
+if (args.project) configuredVars.push('ATOLL_PROJECT')
+if (args.team) configuredVars.push('ATOLL_TEAM')
+if (args.baseUrl) configuredVars.push('ATOLL_BASE_URL')
+console.log(`Configured ${configuredVars.join(', ')} in ${settingsPath}`)
 
 console.log(`\nDone! Start Claude Code and the atoll-api skill will be available.`)
 console.log(`Try: "List my Atoll tasks" or "Check my heartbeat"`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-claude",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Install the Atoll project management skill for Claude Code",
   "bin": {
     "skill-claude": "bin/install.mjs"

package/skill/SKILL.md

@@ -64,7 +64,7 @@ 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 login --profile agent-b --key sk_atoll_... --org client --project project-id --team team-id
 atoll auth profiles
 atoll auth use agent-a
 
@@ -72,6 +72,8 @@ atoll auth use agent-a
 atoll --profile agent-b issue list
 ```
 
+Profiles can store default project, team, and base URL values. `atoll issue list` and `atoll issue create` apply the selected default team unless a command-level `--team` override is passed.
+
 Common commands:
 
 ```bash

package/skill/references/api-endpoints.md

@@ -398,7 +398,9 @@ URL must be HTTPS. Returns webhook record plus `secret` for HMAC verification.
 | POST | `/api/orgs/{id}/agents/{agentId}/keys` | Generate new key |
 | DELETE | `/api/orgs/{id}/agents/{agentId}/keys/{keyId}` | Revoke key |
 | POST | `/api/orgs/{id}/agents/{agentId}/rotate` | Rotate all keys |
-| POST | `/api/orgs/{id}/agents/{agentId}/install-snippets` | Get install snippets (`{ key }`) |
+| POST | `/api/orgs/{id}/agents/{agentId}/install-snippets` | Get install snippets (`{ key, profileName?, projectId?, teamId?, baseUrl? }`) |
+
+Install snippets returns config for `claude-code`, `codex`, `gemini`, `openclaw` (agent prompt), `openclaw-manual`, `hermes` (agent prompt), and `hermes-manual`. The server resolves the org slug and validates optional project/team IDs before generating snippets.
 
 ## Integrations