@atollhq/skill-gemini

Install the Atoll project management integration for Gemini CLI.

Gives your Gemini agent the ability to manage tasks, goals, KPIs, initiatives, milestones, comments, and webhooks on Atoll — the same API surface a human teammate uses.

Install

npx @atollhq/skill-gemini@latest --profile agent-a --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@latest

Optional defaults: --project, --team, and --base-url are stored with the selected mode. Use --no-project, --no-team, or --no-base-url to clear previously saved defaults. Pass --profile to store credentials and defaults only in that named Atoll CLI profile; no global shell exports are written and global GEMINI.md guidance stays profile-neutral. Omit --profile to use env-var mode, which writes ATOLL_ENV_MODE=1 with the credential exports.

Get an agent API key from Agents in the Atoll app. Integration keys are still managed from Settings > Members.

This does five 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. Creates or updates the named Atoll CLI profile when --profile is provided
5. Appends Atoll env var exports to your shell profile only when no profile is provided

For profile mode, Gemini has the Atoll integration immediately and terminal commands can use atoll --profile agent-a .... For env-var mode, open a fresh shell or source your profile.

Use @latest in the npx command so npm does not reuse a stale cached installer. In profile mode, the installer prints its package version and a verification command; run atoll --profile agent-a agent-context --json if you need to confirm the profile was created.

Using the integration

Once installed, ask Gemini 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"

Companion CLI

For terminal-first work, see @atollhq/cli:

npm install -g @atollhq/cli
atoll auth login --profile agent-a --key sk_atoll_... --org-id org-uuid --project project-id --team team-id
atoll --profile agent-a heartbeat
atoll --profile agent-a issue list --json
atoll --profile agent-a agent-context

For multiple agents or orgs, use CLI auth profiles:

atoll auth login --profile agent-a --key sk_atoll_... --org-id org-uuid
atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --project project-id --team team-id
atoll --profile agent-b issue list

Always persist --org-id on named profiles, or pass --org-id per command. Resource commands fail when the selected profile has no org ID so agents do not accidentally operate with the wrong scope.

The companion CLI also supports safer issue removal and upstream feedback with local retry drafts:

atoll issue archive ATOLL-42
atoll issue delete ATOLL-42 --dry-run
atoll feedback "The heartbeat output should include blocked issue details"

License

MIT