setup

Documentation

Overview

Package setup handles agent plugin installation.

- OpenCode: copies embedded plugin file to ~/.config/opencode/plugins/ - Claude Code: runs `claude plugin marketplace add` + `claude plugin install` - Gemini CLI: injects MCP registration in ~/.gemini/settings.json - Codex: injects MCP registration in ~/.codex/config.toml

Index

• func AddClaudeCodeAllowlist() error
• type Agent
  • func SupportedAgents() []Agent
• type Result
  • func Install(agentName string) (*Result, error)

Functions

func AddClaudeCodeAllowlist

func AddClaudeCodeAllowlist() error

AddClaudeCodeAllowlist adds engram MCP tool names to ~/.claude/settings.json permissions.allow so Claude Code doesn't prompt for confirmation on each call. Idempotent: skips tools already present in the list.

Types

type Agent

type Agent struct {
	Name        string
	Description string
	InstallDir  string // resolved at runtime (display only for claude-code)
}

Agent represents a supported AI coding agent.

func SupportedAgents

func SupportedAgents() []Agent

SupportedAgents returns the list of agents that have plugins available.

type Result

type Result struct {
	Agent       string
	Destination string
	Files       int
}

Result holds the outcome of an installation.

func Install

func Install(agentName string) (*Result, error)

Install installs the plugin for the given agent.