@atollhq/skill-gemini 0.1.10 → 0.1.12

package/README.md

@@ -7,11 +7,13 @@ 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-id
+npx @atollhq/skill-gemini --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-gemini
 ```
 
+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 four things:
@@ -19,7 +21,7 @@ This does four things:
 1. Installs the `atoll-api` skill to `~/.gemini/skills/atoll-api/`
 2. Appends (or updates) an `# Atoll Integration` section in `~/.gemini/GEMINI.md`
 3. Copies API reference files to `~/.gemini/atoll-references/`
-4. Appends `ATOLL_API_KEY` and `ATOLL_ORG_ID` exports to your shell profile (`~/.zshrc` or `~/.bashrc`)
+4. Appends Atoll env var exports to your shell profile (`~/.zshrc` or `~/.bashrc`)
 
 Open a fresh shell (or `source` your profile) and Gemini has the Atoll integration.
 
@@ -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

@@ -12,6 +12,9 @@ function parseArgs(argv) {
   for (let i = 2; i < argv.length; i++) {
     if (argv[i] === '--key' && argv[i + 1]) 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
   }
   return args
@@ -19,24 +22,30 @@ function parseArgs(argv) {
 
 function printUsage() {
   console.log(`
-Usage: npx @atollhq/skill-gemini --key <api-key> --org <org-id>
+Usage: npx @atollhq/skill-gemini --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-gemini
 
 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
 
 Installs the Atoll integration for Gemini CLI:
   - Installs the atoll-api skill to ~/.gemini/skills/atoll-api/
   - Writes GEMINI.md with API reference to ~/.gemini/
-  - Sets ATOLL_API_KEY and ATOLL_ORG_ID env vars
+  - Sets Atoll env vars
 `)
 }
 
 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(); process.exit(0) }
 
@@ -64,6 +73,11 @@ console.log(`Installed Atoll skill to ${skillDest}`)
 // 2. Write GEMINI.md to ~/.gemini/
 const skillMd = readFileSync(join(skillDir, 'SKILL.md'), 'utf-8')
 const body = skillMd.replace(/^---[\s\S]*?---\n*/, '')
+const optionalCredentialLines = [
+  args.project ? `- Default project ID: ${args.project}` : null,
+  args.team ? `- Default team: ${args.team}` : null,
+  args.baseUrl ? `- Base URL: ${args.baseUrl}` : null,
+].filter(Boolean).join('\n')
 
 const geminiMd = `# Atoll Integration
 
@@ -72,7 +86,7 @@ ${body}
 ## Credentials
 
 - API Key: set as ATOLL_API_KEY environment variable
-- Org ID: ${args.org}
+- Org ID: ${args.org}${optionalCredentialLines ? `\n${optionalCredentialLines}` : ''}
 `
 
 const geminiPath = join(geminiDir, 'GEMINI.md')
@@ -117,12 +131,27 @@ if (existsSync(profilePath)) {
   }
   profile = upsertExport(profile, 'ATOLL_API_KEY', args.key)
   profile = upsertExport(profile, 'ATOLL_ORG_ID', args.org)
+  if (args.project) profile = upsertExport(profile, 'ATOLL_PROJECT', args.project)
+  if (args.team) profile = upsertExport(profile, 'ATOLL_TEAM', args.team)
+  if (args.baseUrl) profile = upsertExport(profile, 'ATOLL_BASE_URL', args.baseUrl)
   writeFileSync(profilePath, profile)
-  console.log(`Configured ATOLL_API_KEY and ATOLL_ORG_ID in ${profilePath}`)
+  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 ${profilePath}`)
 } else {
-  const envBlock = `\n# Atoll (added by @atollhq/skill-gemini)\nexport ATOLL_API_KEY="${args.key}"\nexport ATOLL_ORG_ID="${args.org}"\n`
+  const envLines = [
+    '# Atoll (added by @atollhq/skill-gemini)',
+    `export ATOLL_API_KEY="${args.key}"`,
+    `export ATOLL_ORG_ID="${args.org}"`,
+    args.project ? `export ATOLL_PROJECT="${args.project}"` : null,
+    args.team ? `export ATOLL_TEAM="${args.team}"` : null,
+    args.baseUrl ? `export ATOLL_BASE_URL="${args.baseUrl}"` : null,
+  ].filter(Boolean)
+  const envBlock = `\n${envLines.join('\n')}\n`
   writeFileSync(profilePath, envBlock)
-  console.log(`Created ${profilePath} with ATOLL_API_KEY and ATOLL_ORG_ID`)
+  console.log(`Created ${profilePath} with Atoll env vars`)
 }
 
 console.log(`\nDone! Restart your shell, then Gemini CLI will have access to the Atoll API.`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-gemini",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Install the Atoll project management integration for Gemini CLI",
   "bin": {
     "skill-gemini": "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