gemini

package
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 25, 2026 License: MIT Imports: 15 Imported by: 0

Documentation

Overview

Package gemini provides Gemini CLI specific configuration and path handling.

Index

Constants

View Source 
const (
	VarArguments = "$ARGUMENTS"
	VarSelection = "$SELECTION"
)

Variables supported by Gemini CLI.

Variables

View Source 
var (
	ErrAgentNotFound = errors.New("agent not found")
	ErrInvalidAgent  = errors.New("invalid agent: name required")
)

Sentinel errors for agent operations.

View Source 
var (
	ErrCommandNotFound = errors.New("command not found")
	ErrInvalidCommand  = errors.New("invalid command: name required")
)

Sentinel errors for command operations.

View Source 
var (
	ErrMCPServerNotFound = errors.New("MCP server not found")
	ErrInvalidMCPServer  = errors.New("invalid MCP server: name required")
)

Sentinel errors for MCP operations.

View Source 
var (
	ErrSkillNotFound = errors.New("skill not found")
	ErrInvalidSkill  = errors.New("invalid skill: name required")
)

Sentinel errors for skill operations.

View Source 
var ErrUnsupportedVariable = errors.New("unsupported variable")

ErrUnsupportedVariable indicates content contains variables not supported by Gemini CLI.

Functions

func ListVariables 

func ListVariables(content string) []string

ListVariables returns all canonical variables found in the content.

func TranslateToCanonical 

func TranslateToCanonical(content string) string

TranslateToCanonical converts Gemini CLI variable syntax to canonical format. {{args}} -> $ARGUMENTS {{argument}} -> $ARGUMENTS {{selection}} -> $SELECTION

func TranslateVariables 

func TranslateVariables(content string) string

TranslateVariables converts canonical variable syntax to Gemini CLI format. $ARGUMENTS -> {{args}} $SELECTION -> {{selection}}

func ValidateVariables 

func ValidateVariables(content string) error

ValidateVariables checks if content contains only supported variables.

Types

type Agent 

type Agent struct {
	// Name is the agent's identifier.
	Name string `yaml:"name" json:"name" toml:"name"`

	// Description explains the agent's purpose.
	Description string `yaml:"description,omitempty" json:"description,omitempty" toml:"description,omitempty"`

	// Instructions contains the agent's markdown body content.
	Instructions string `yaml:"-" json:"-" toml:"instructions"`
}

Agent represents a Gemini CLI agent definition.

func (*Agent) GetDescription 

func (a *Agent) GetDescription() string

GetDescription returns the agent's description.

func (*Agent) GetInstructions 

func (a *Agent) GetInstructions() string

GetInstructions returns the agent's instructions.

func (*Agent) GetName 

func (a *Agent) GetName() string

GetName returns the agent's name.

type AgentManager 

type AgentManager struct {
	// contains filtered or unexported fields
}

AgentManager provides CRUD operations for Gemini CLI agents.

func NewAgentManager 

func NewAgentManager(paths *GeminiPaths) *AgentManager

NewAgentManager creates a new AgentManager with the given paths configuration.

func (*AgentManager) Get 

func (m *AgentManager) Get(name string) (*Agent, error)

Get retrieves an agent by name.

func (*AgentManager) Install 

func (m *AgentManager) Install(a *Agent) error

Install writes an agent to disk in TOML format.

func (*AgentManager) List 

func (m *AgentManager) List() ([]*Agent, error)

List returns all agents in the agents directory.

func (*AgentManager) Uninstall 

func (m *AgentManager) Uninstall(name string) error

Uninstall removes an agent from disk.

type Command 

type Command struct {
	// Name is the command's identifier.
	Name string `yaml:"name" json:"name" toml:"name"`

	// Description explains what the command does.
	Description string `yaml:"description,omitempty" json:"description,omitempty" toml:"description,omitempty"`

	// Instructions contains the command's markdown body content.
	Instructions string `yaml:"-" json:"-" toml:"instructions"`
}

Command represents a Gemini CLI slash command definition.

func (*Command) GetName 

func (c *Command) GetName() string

GetName returns the command's name.

func (*Command) SetInstructions 

func (c *Command) SetInstructions(instructions string)

SetInstructions sets the command's instructions.

func (*Command) SetName 

func (c *Command) SetName(name string)

SetName sets the command's name.

type CommandManager 

type CommandManager struct {
	// contains filtered or unexported fields
}

CommandManager provides CRUD operations for Gemini CLI slash commands.

func NewCommandManager 

func NewCommandManager(paths *GeminiPaths) *CommandManager

NewCommandManager creates a new CommandManager with the given paths configuration.

func (*CommandManager) Get 

func (m *CommandManager) Get(name string) (*Command, error)

Get retrieves a command by name.

func (*CommandManager) Install 

func (m *CommandManager) Install(c *Command) error

Install writes a command to disk in TOML format.

func (*CommandManager) List 

func (m *CommandManager) List() ([]*Command, error)

List returns all commands in the commands directory.

func (*CommandManager) Uninstall 

func (m *CommandManager) Uninstall(name string) error

Uninstall removes a command from disk.

type GeminiPaths 

type GeminiPaths struct {
	// contains filtered or unexported fields
}

GeminiPaths provides Gemini-specific path resolution. It wraps the generic paths package with Gemini-specific defaults.

func NewGeminiPaths 

func NewGeminiPaths(scope Scope, projectRoot string) *GeminiPaths

NewGeminiPaths creates a new GeminiPaths instance. For ScopeProject, projectRoot must be non-empty. For ScopeUser, projectRoot is ignored.

func (*GeminiPaths) AgentDir 

func (p *GeminiPaths) AgentDir() string

AgentDir returns the agents directory. Returns <base>/agents/

func (*GeminiPaths) AgentPath 

func (p *GeminiPaths) AgentPath(name string) string

AgentPath returns the path to a specific agent file. Returns <agents>/<name>.toml Returns empty string if name is empty.

func (*GeminiPaths) BaseDir 

func (p *GeminiPaths) BaseDir() string

BaseDir returns the base configuration directory. For ScopeUser: ~/.gemini/ For ScopeProject: <projectRoot>/.gemini/ Returns empty string if projectRoot is empty for ScopeProject.

func (*GeminiPaths) CommandDir 

func (p *GeminiPaths) CommandDir() string

CommandDir returns the commands directory. Returns <base>/commands/

func (*GeminiPaths) CommandPath 

func (p *GeminiPaths) CommandPath(name string) string

CommandPath returns the path to a specific command file. Returns <commands>/<name>.toml Returns empty string if name is empty.

func (*GeminiPaths) InstructionsPath 

func (p *GeminiPaths) InstructionsPath() string

InstructionsPath returns the path to the GEMINI.md instructions file. For ScopeUser: ~/.gemini/GEMINI.md For ScopeProject: <projectRoot>/GEMINI.md (note: at project root, not .gemini/)

func (*GeminiPaths) MCPConfigPath 

func (p *GeminiPaths) MCPConfigPath() string

MCPConfigPath returns the path to the MCP servers configuration file. Returns <base>/settings.json

func (*GeminiPaths) SkillDir 

func (p *GeminiPaths) SkillDir() string

SkillDir returns the skills directory. Returns <base>/skills/

func (*GeminiPaths) SkillPath 

func (p *GeminiPaths) SkillPath(name string) string

SkillPath returns the path to a specific skill's SKILL.md file. Returns <skills>/<name>/SKILL.md Returns empty string if name is empty.

type GeminiPlatform 

type GeminiPlatform struct {
	// contains filtered or unexported fields
}

GeminiPlatform provides the unified platform adapter for Gemini CLI.

func NewGeminiPlatform 

func NewGeminiPlatform(opts ...Option) *GeminiPlatform

NewGeminiPlatform creates a new GeminiPlatform with the given options.

func (*GeminiPlatform) AddMCP 

func (p *GeminiPlatform) AddMCP(s *MCPServer) error

func (*GeminiPlatform) AgentDir 

func (p *GeminiPlatform) AgentDir() string

func (*GeminiPlatform) BackupPaths 

func (p *GeminiPlatform) BackupPaths() []string

func (*GeminiPlatform) CommandDir 

func (p *GeminiPlatform) CommandDir() string

func (*GeminiPlatform) DisableMCP 

func (p *GeminiPlatform) DisableMCP(name string) error

func (*GeminiPlatform) DisplayName 

func (p *GeminiPlatform) DisplayName() string

func (*GeminiPlatform) EnableMCP 

func (p *GeminiPlatform) EnableMCP(name string) error

func (*GeminiPlatform) GetAgent 

func (p *GeminiPlatform) GetAgent(name string) (*Agent, error)

func (*GeminiPlatform) GetCommand 

func (p *GeminiPlatform) GetCommand(name string) (*Command, error)

func (*GeminiPlatform) GetMCP 

func (p *GeminiPlatform) GetMCP(name string) (*MCPServer, error)

func (*GeminiPlatform) GetSkill 

func (p *GeminiPlatform) GetSkill(name string) (*Skill, error)

func (*GeminiPlatform) GlobalConfigDir 

func (p *GeminiPlatform) GlobalConfigDir() string

func (*GeminiPlatform) InstallAgent 

func (p *GeminiPlatform) InstallAgent(a *Agent) error

func (*GeminiPlatform) InstallCommand 

func (p *GeminiPlatform) InstallCommand(c *Command) error

func (*GeminiPlatform) InstallSkill 

func (p *GeminiPlatform) InstallSkill(s *Skill) error

func (*GeminiPlatform) InstructionsPath 

func (p *GeminiPlatform) InstructionsPath(projectRoot string) string

func (*GeminiPlatform) IsAvailable 

func (p *GeminiPlatform) IsAvailable() bool

func (*GeminiPlatform) ListAgents 

func (p *GeminiPlatform) ListAgents() ([]*Agent, error)

func (*GeminiPlatform) ListCommands 

func (p *GeminiPlatform) ListCommands() ([]*Command, error)

func (*GeminiPlatform) ListMCP 

func (p *GeminiPlatform) ListMCP() ([]*MCPServer, error)

func (*GeminiPlatform) ListSkills 

func (p *GeminiPlatform) ListSkills() ([]*Skill, error)

func (*GeminiPlatform) MCPConfigPath 

func (p *GeminiPlatform) MCPConfigPath() string

func (*GeminiPlatform) Name 

func (p *GeminiPlatform) Name() string

func (*GeminiPlatform) ProjectConfigDir 

func (p *GeminiPlatform) ProjectConfigDir(projectRoot string) string

func (*GeminiPlatform) RemoveMCP 

func (p *GeminiPlatform) RemoveMCP(name string) error

func (*GeminiPlatform) SkillDir 

func (p *GeminiPlatform) SkillDir() string

func (*GeminiPlatform) TranslateToCanonical 

func (p *GeminiPlatform) TranslateToCanonical(content string) string

func (*GeminiPlatform) TranslateVariables 

func (p *GeminiPlatform) TranslateVariables(content string) string

func (*GeminiPlatform) UninstallAgent 

func (p *GeminiPlatform) UninstallAgent(name string) error

func (*GeminiPlatform) UninstallCommand 

func (p *GeminiPlatform) UninstallCommand(name string) error

func (*GeminiPlatform) UninstallSkill 

func (p *GeminiPlatform) UninstallSkill(name string) error

func (*GeminiPlatform) ValidateVariables 

func (p *GeminiPlatform) ValidateVariables(content string) error

func (*GeminiPlatform) Version 

func (p *GeminiPlatform) Version() (string, error)

type MCPConfig 

type MCPConfig struct {
	// Servers maps server names to their configurations.
	Servers map[string]*MCPServer `json:"servers"`
}

MCPConfig represents the MCP section in Gemini CLI's settings.json.

type MCPManager 

type MCPManager struct {
	// contains filtered or unexported fields
}

MCPManager provides CRUD operations for Gemini CLI MCP server configurations.

func NewMCPManager 

func NewMCPManager(paths *GeminiPaths) *MCPManager

NewMCPManager creates a new MCPManager instance.

func (*MCPManager) Add 

func (m *MCPManager) Add(server *MCPServer) error

Add adds or updates an MCP server configuration.

func (*MCPManager) Disable 

func (m *MCPManager) Disable(name string) error

Disable deactivates an MCP server.

func (*MCPManager) Enable 

func (m *MCPManager) Enable(name string) error

Enable activates an MCP server.

func (*MCPManager) Get 

func (m *MCPManager) Get(name string) (*MCPServer, error)

Get returns a single MCP server by name.

func (*MCPManager) List 

func (m *MCPManager) List() ([]*MCPServer, error)

List returns all configured MCP servers.

func (*MCPManager) Remove 

func (m *MCPManager) Remove(name string) error

Remove removes an MCP server configuration.

type MCPServer 

type MCPServer struct {
	// Name is the server's identifier, derived from the map key.
	Name string `json:"-"`

	// Command is the executable path for local servers.
	Command string `json:"command,omitempty"`

	// Args are command-line arguments for the server process.
	Args []string `json:"args,omitempty"`

	// URL is the server endpoint for remote servers.
	URL string `json:"url,omitempty"`

	// Env contains environment variables for the server process.
	Env map[string]string `json:"env,omitempty"`

	// Headers contains HTTP headers for remote connections.
	Headers map[string]string `json:"headers,omitempty"`

	// Enabled indicates whether the server is active.
	Enabled bool `json:"enabled"`
}

MCPServer represents an MCP server configuration for Gemini CLI. Gemini uses an "inferred" transport type based on presence of command or url.

type MCPTranslator 

type MCPTranslator struct{}

MCPTranslator converts between canonical and Gemini CLI MCP formats.

func NewMCPTranslator 

func NewMCPTranslator() *MCPTranslator

NewMCPTranslator creates a new Gemini CLI MCP translator.

func (*MCPTranslator) FromCanonical 

func (t *MCPTranslator) FromCanonical(cfg *mcp.Config) ([]byte, error)

FromCanonical converts canonical MCP configuration to Gemini CLI format.

func (*MCPTranslator) Platform 

func (t *MCPTranslator) Platform() string

Platform returns the platform identifier for this translator.

func (*MCPTranslator) ToCanonical 

func (t *MCPTranslator) ToCanonical(platformData []byte) (*mcp.Config, error)

ToCanonical converts Gemini CLI MCP configuration to canonical format.

type Option 

type Option func(*GeminiPlatform)

Option configures a GeminiPlatform instance.

func WithProjectRoot 

func WithProjectRoot(root string) Option

WithProjectRoot sets the project root directory.

func WithScope 

func WithScope(scope Scope) Option

WithScope sets the scope (user or project) for path resolution.

type Scope 

type Scope int

Scope defines whether paths resolve to user-level or project-level configuration. 

const (
	// ScopeUser resolves paths relative to ~/.gemini/
	ScopeUser Scope = iota
	// ScopeProject resolves paths relative to <projectRoot>/.gemini/
	ScopeProject
)

type Settings 

type Settings struct {
	// MCP contains the MCP server configurations.
	MCP *MCPConfig `json:"mcp,omitempty"`
	// contains filtered or unexported fields
}

Settings represents the root structure of Gemini CLI's settings.json. It preserves unknown fields to avoid data loss when modifying MCP section.

func (*Settings) MarshalJSON 

func (s *Settings) MarshalJSON() ([]byte, error)

MarshalJSON implements json.Marshaler.

func (*Settings) UnmarshalJSON 

func (s *Settings) UnmarshalJSON(data []byte) error

UnmarshalJSON implements json.Unmarshaler.

type Skill 

type Skill struct {
	// Name is the skill's unique identifier (required).
	Name string `yaml:"name" json:"name"`

	// Description explains what the skill does (required).
	Description string `yaml:"description" json:"description"`

	// License is the SPDX license identifier (optional).
	License string `yaml:"license,omitempty" json:"license,omitempty"`

	// Compatibility lists compatible AI assistants (optional).
	Compatibility []string `yaml:"compatibility,omitempty" json:"compatibility,omitempty"`

	// Metadata contains optional key-value pairs like author, version, repository.
	Metadata map[string]string `yaml:"metadata,omitempty" json:"metadata,omitempty"`

	// AllowedTools lists the tool permissions required by this skill.
	AllowedTools ToolList `yaml:"allowed-tools,omitempty" json:"allowed-tools,omitempty"`

	// Instructions contains the skill's markdown body content.
	// This field is not part of the YAML frontmatter.
	Instructions string `yaml:"-" json:"-"`
}

Skill represents a skill definition per the Agent Skills Specification. Skills are markdown files with YAML frontmatter that define reusable capabilities.

type SkillManager 

type SkillManager struct {
	// contains filtered or unexported fields
}

SkillManager handles CRUD operations for Gemini CLI skills.

func NewSkillManager 

func NewSkillManager(paths *GeminiPaths) *SkillManager

NewSkillManager creates a new SkillManager with the given paths configuration.

func (*SkillManager) Get 

func (m *SkillManager) Get(name string) (*Skill, error)

Get retrieves a skill by name.

func (*SkillManager) Install 

func (m *SkillManager) Install(s *Skill) error

Install creates or overwrites a skill.

func (*SkillManager) List 

func (m *SkillManager) List() ([]*Skill, error)

List returns all skills in the skill directory.

func (*SkillManager) Uninstall 

func (m *SkillManager) Uninstall(name string) error

Uninstall removes a skill by name.

type ToolList 

type ToolList []string

ToolList is a list of allowed tools. It supports unmarshaling from both a space-delimited string and a list of strings.

func (ToolList) String 

func (t ToolList) String() string

String returns the space-delimited string representation.

func (*ToolList) UnmarshalYAML 

func (t *ToolList) UnmarshalYAML(value *yaml.Node) error

UnmarshalYAML implements yaml.Unmarshaler.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.