@atollhq/skill-gemini 0.1.5 → 0.1.7

package/README.md

@@ -7,7 +7,7 @@ Gives your Gemini agent the ability to manage tasks, goals, KPIs, initiatives, m
 ## Install
 
 ```bash
-npx @atollhq/skill-gemini --key sk_atoll_... --org your-org-slug
+npx @atollhq/skill-gemini --key sk_atoll_... --org your-org-id
 ```
 
 Get an API key from **Settings > Members > Add Agent** (or **Create API Key** for integrations) in the Atoll app.
@@ -16,7 +16,7 @@ This does three things:
 
 1. Appends (or updates) an `# Atoll Integration` section in `~/.gemini/GEMINI.md`
 2. Copies API reference files to `~/.gemini/atoll-references/`
-3. Appends `ATOLL_API_KEY` and `ATOLL_ORG_SLUG` exports to your shell profile (`~/.zshrc` or `~/.bashrc`)
+3. Appends `ATOLL_API_KEY` and `ATOLL_ORG_ID` exports to your shell profile (`~/.zshrc` or `~/.bashrc`)
 
 Open a fresh shell (or `source` your profile) and Gemini has the Atoll integration.
 
@@ -42,6 +42,14 @@ atoll config set-org your-org-slug
 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 login --profile agent-b --key sk_atoll_... --org client
+atoll --profile agent-b issue list
+```
+
 ## License
 
 MIT

package/bin/install.mjs

@@ -19,16 +19,16 @@ function parseArgs(argv) {
 
 function printUsage() {
   console.log(`
-Usage: npx @atollhq/skill-gemini --key <api-key> --org <org-slug>
+Usage: npx @atollhq/skill-gemini --key <api-key> --org <org-id>
 
 Options:
   --key   Atoll API key (sk_atoll_...)
-  --org   Organization slug
+  --org   Organization ID
   --help  Show this help message
 
 Installs the Atoll integration for Gemini CLI:
   - Writes GEMINI.md with API reference to ~/.gemini/
-  - Sets ATOLL_API_KEY and ATOLL_ORG_SLUG env vars
+  - Sets ATOLL_API_KEY and ATOLL_ORG_ID env vars
 `)
 }
 
@@ -62,7 +62,7 @@ ${body}
 ## Credentials
 
 - API Key: set as ATOLL_API_KEY environment variable
-- Org: ${args.org}
+- Org ID: ${args.org}
 `
 
 const geminiPath = join(geminiDir, 'GEMINI.md')
@@ -93,19 +93,26 @@ const profilePath = shell.includes('zsh')
   ? join(homedir(), '.zshrc')
   : join(homedir(), '.bashrc')
 
-const envBlock = `\n# Atoll (added by @atollhq/skill-gemini)\nexport ATOLL_API_KEY="${args.key}"\nexport ATOLL_ORG_SLUG="${args.org}"\n`
+function upsertExport(profile, name, value) {
+  const line = `export ${name}="${value}"`
+  const pattern = new RegExp(`^export ${name}=.*$`, 'm')
+  if (pattern.test(profile)) return profile.replace(pattern, line)
+  return `${profile.trimEnd()}\n${line}\n`
+}
 
 if (existsSync(profilePath)) {
-  const profile = readFileSync(profilePath, 'utf-8')
-  if (profile.includes('ATOLL_API_KEY')) {
-    console.log(`ATOLL_API_KEY already set in ${profilePath} — update manually if needed`)
-  } else {
-    writeFileSync(profilePath, profile.trimEnd() + '\n' + envBlock)
-    console.log(`Added ATOLL_API_KEY and ATOLL_ORG_SLUG to ${profilePath}`)
+  let profile = readFileSync(profilePath, 'utf-8')
+  if (!profile.includes('# Atoll (added by @atollhq/skill-gemini)')) {
+    profile = `${profile.trimEnd()}\n\n# Atoll (added by @atollhq/skill-gemini)\n`
   }
+  profile = upsertExport(profile, 'ATOLL_API_KEY', args.key)
+  profile = upsertExport(profile, 'ATOLL_ORG_ID', args.org)
+  writeFileSync(profilePath, profile)
+  console.log(`Configured ATOLL_API_KEY and ATOLL_ORG_ID in ${profilePath}`)
 } else {
+  const envBlock = `\n# Atoll (added by @atollhq/skill-gemini)\nexport ATOLL_API_KEY="${args.key}"\nexport ATOLL_ORG_ID="${args.org}"\n`
   writeFileSync(profilePath, envBlock)
-  console.log(`Created ${profilePath} with ATOLL_API_KEY and ATOLL_ORG_SLUG`)
+  console.log(`Created ${profilePath} with ATOLL_API_KEY and ATOLL_ORG_ID`)
 }
 
 console.log(`\nDone! Restart your shell, then Gemini CLI will have access to the Atoll API.`)

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@atollhq/skill-gemini",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Install the Atoll project management integration for Gemini CLI",
   "bin": {
-    "skill-gemini": "./bin/install.mjs"
+    "skill-gemini": "bin/install.mjs"
   },
   "files": [
     "bin/",
@@ -18,7 +18,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/atollhq/atoll.git",
+    "url": "git+https://github.com/atollhq/atoll.git",
     "directory": "packages/skill-gemini"
   },
   "license": "MIT",

package/skill/SKILL.md

@@ -60,6 +60,18 @@ atoll auth login --key sk_atoll_...
 atoll config set-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 profiles
+atoll auth use agent-a
+
+# Run one command as a specific profile
+atoll --profile agent-b issue list
+```
+
 Common commands:
 
 ```bash
@@ -150,6 +162,12 @@ Every KPI snapshot can be attributed to an initiative or issue, building a recor
 
 `POST /api/orgs/{id}/issues/bulk` with `{ "issues": [{...}, ...] }` (max 50).
 
+### Billing and plan limits
+
+Owners/admins can read billing state with `GET /api/orgs/{id}/billing` and start Stripe checkout with `POST /api/orgs/{id}/billing/checkout` using `{ "plan": "starter" }` or `{ "plan": "team" }`.
+
+Creation endpoints can return `402` with `code: "PLAN_LIMIT_REACHED"` when an org reaches limits for humans, agents/integrations, active projects, or active issues.
+
 ## API Reference
 
 Full endpoint tables and field schemas:

package/skill/references/api-endpoints.md

@@ -10,6 +10,7 @@ All endpoints require `Authorization: Bearer sk_atoll_...` header.
 - [Projects](#projects)
 - [Project Members](#project-members)
 - [Project Teams](#project-teams)
+- [Billing](#billing)
 - [Tasks (Issues)](#tasks-issues)
 - [Dependencies](#dependencies)
 - [Comments](#comments)
@@ -85,6 +86,18 @@ Access levels: `view`, `edit`, `admin` (default: `view`).
 | POST | `/api/orgs/{id}/projects/{projectId}/teams` | Add team (`{ teamId }`) |
 | DELETE | `/api/orgs/{id}/projects/{projectId}/teams?teamId=...` | Remove team |
 
+## Billing
+
+Org billing is managed through Stripe. Owners/admins can create checkout and billing portal sessions.
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/orgs/{id}/billing` | Get plan, status, usage, limits, and subscription summary |
+| POST | `/api/orgs/{id}/billing/checkout` | Create Stripe Checkout Session (`{ plan: "starter" \| "team" }`) |
+| POST | `/api/orgs/{id}/billing/portal` | Create Stripe Billing Portal Session |
+
+Plan limits are enforced when creating projects, human members, agents/integrations, and active tasks. Limit errors return `402` with `code: "PLAN_LIMIT_REACHED"`.
+
 ## Tasks (Issues)
 
 | Method | Endpoint | Description |

package/skill/references/api-fields.md

@@ -12,6 +12,7 @@
 - [Webhook Fields](#webhook-fields)
 - [Heartbeat Response](#heartbeat-response)
 - [Analytics Response](#analytics-response)
+- [Plan Limit Errors](#plan-limit-errors)
 - [Enums](#enums)
 
 ---
@@ -53,6 +54,23 @@ All fields work on both POST (create) and PATCH (update).
 ```
 Returns `{ issues: [...], count: N }` (201). Max 50 per request.
 
+## Plan Limit Errors
+
+Creation endpoints may return `402` when an org reaches its billing plan limit:
+
+```json
+{
+  "error": "Plan limit reached",
+  "code": "PLAN_LIMIT_REACHED",
+  "resource": "activeProjects",
+  "plan": "free",
+  "limit": 2,
+  "usage": 2
+}
+```
+
+`resource` is one of `humans`, `agents`, `activeProjects`, or `activeIssues`.
+
 ## Goal Fields
 
 ```json
@@ -234,7 +252,7 @@ URL must be HTTPS. Response includes `secret` for HMAC signature verification.
 
 ## Response Format
 
-All endpoints return JSON. Successful: `200` or `201`. Errors: `{ "error": "message" }` with `400`, `401`, `403`, `404`, `409`, or `500`.
+All endpoints return JSON. Successful: `200` or `201`. Errors: `{ "error": "message" }` with `400`, `401`, `402`, `403`, `404`, `409`, or `500`.
 
 List responses include `total`, `limit`, `offset` for pagination.