Skip to main content

Claude Code Plugin Setup

The AgentGate plugin for Claude Code adds automatic project context, a /jira skill with built-in documentation, and session continuity hooks. It's optional but recommended for Claude Code users.

Prerequisites​

Installation​

claude plugin add github:Orbiscend/agentgate-claude-plugin

That's it. The plugin is active immediately for all Claude Code sessions.

What the Plugin Provides​

Auto-Context on Session Start​

When you start a new Claude Code session, the plugin automatically runs jd prime to load your project context. This means Claude immediately knows:

  • What issues are in progress
  • What changes are pending review
  • What failed changes need attention

No need to manually ask "what's the project status?" at the start of every session.

Pre-Compaction Hook​

When Claude Code runs low on context and needs to compact the conversation, the plugin runs jd prime again before compaction. This ensures project context survives the compaction and Claude doesn't lose track of what it was working on.

/jira Skill​

The plugin includes a /jira skill with comprehensive documentation about:

  • How to use all AgentGate tools effectively
  • Approval workflow rules and best practices
  • Issue planning patterns (types, sizing, acceptance criteria, relationships)
  • Common workflow patterns

Invoke it with /jira in your Claude Code session for instant reference.

Configuration​

The plugin uses the same configuration as the CLI. If you've already run jd init --global, the plugin works automatically.

If you need project-specific config, create .agentgate-for-jira/config.json in your project directory:

{
  "endpoint": "https://your-endpoint-url",
  "token": "jfa_your_token",
  "project": "PROJ"
}

Customizing PRIME.md​

You can customize what context the plugin loads on session start by creating .agentgate-for-jira/PRIME.md in your project directory. See CLI Setup — Custom PRIME.md for details.

This is especially useful for embedding project-specific workflow rules:

# Project Rules

- All bugs must have a priority set
- Use labels: backend, frontend, infra
- Link related issues with "relates to"

{{pending_changes}}
{{failed_changes}}

Uninstalling​

claude plugin remove agentgate-for-jira