Get up and running with Gnoll using the Claude Code plugin in under 5 minutes.
Click Register on the home page. Enter a username and password — no email confirmation required.
Then go to Projects and create your first project. Select it from the project dropdown in the sidebar.
Go to API Keys and generate a new key. Copy it — you'll need it in the next step.
First, add the marketplace (one time):
claude plugin marketplace add aml630/gnoll-claude-plugin
Then install the plugin:
claude plugin install gnoll
Finally, initialize it with your API key:
/tsa-init --key YOUR_API_KEY
This connects Claude to your Gnoll instance and creates an AGENTS.md file in your repo root. This file tells AI agents how to use Gnoll for issue tracking — commit it to your repo so all agents pick it up automatically.
Just tell Claude what you need to do in natural language:
"Create a task to add user avatar uploads with priority 2"
Or use the slash command directly:
/create Add user avatar uploads task 2
Claude will create the issue with the right type, priority, and description. You can also ask Claude to break down larger work into multiple issues:
"Break down the authentication feature into tasks"
Use these commands in Claude Code to manage your workflow:
/list — See your open issues/ready — See issues with no unresolved blockers/claim <id> — Assign an issue to yourself/show <id> — View issue details/close <id> — Close an issue when doneClaude keeps track of your project context, so you can also ask things like "what should I work on next?" or "show me what's blocked."
Tell Claude about dependencies between issues:
/dep <issue-id> --on <blocker-id>
Or describe it naturally: "Make the API task depend on the database schema task." Closing a blocker automatically unblocks everything waiting on it.
Now that you're set up, explore these features:
/prime in Claude Code to refresh Claude's context if things get stale.