command

Documentation

Index

• func Exists(path string) bool
• func Save(cmd *Command, dir string) error
• type Arg
• type Command
  • func Load(path string) (*Command, error)
  • func LoadAll(dir string) ([]*Command, error)
  • func LoadMarkdown(path string) (*Command, error)
  • func (c *Command) InspectContent() string
  • func (c *Command) InspectTitle() string
• type MarkdownFrontmatter
• type ToolOverride

Functions

func Exists

func Exists(path string) bool

Exists checks if a command file exists

func Save

func Save(cmd *Command, dir string) error

Save saves a command to a directory

Types

type Arg

type Arg struct {
	Type        string   `json:"type"`                  // "string", "number", "boolean"
	Enum        []string `json:"enum,omitempty"`        // Allowed values
	Default     any      `json:"default,omitempty"`     // Default value
	Description string   `json:"description,omitempty"` // Help text
	Required    bool     `json:"required,omitempty"`    // Is this arg required?
}

Arg represents a command argument definition

type Command

type Command struct {
	Name            string                  `json:"name"`
	Description     string                  `json:"description"`
	Prompt          string                  `json:"prompt"`
	ArgumentHint    string                  `json:"argumentHint,omitempty"`    // Hint for expected arguments (e.g., "[file.md or feature]")
	Model           string                  `json:"model,omitempty"`           // Preferred model (opus, sonnet, haiku, gpt-4, etc.)
	Args            map[string]Arg          `json:"args,omitempty"`            // Structured argument definitions
	AllowedTools    []string                `json:"allowedTools,omitempty"`    // Tools this command can use
	DisallowedTools []string                `json:"disallowedTools,omitempty"` // Tools this command cannot use
	Overrides       map[string]ToolOverride `json:"overrides,omitempty"`       // Per-tool overrides
	PromptRef       string                  `json:"promptRef,omitempty"`       // Reference to a prompt template

	// Runtime fields (not serialized)
	Scope string `json:"-"` // "local" or "global" - where this command came from
	Tool  string `json:"-"` // Which tool owns this (e.g., "claude", "gemini", "agentctl")
	Path  string `json:"-"` // Path to the source file
}

Command represents a slash command configuration

func Load

func Load(path string) (*Command, error)

Load loads a command from a JSON file

func LoadAll

func LoadAll(dir string) ([]*Command, error)

LoadAll loads all commands from a directory (recursively includes subdirectories) Supports both JSON format (.json) and markdown format (.md)

func LoadMarkdown

func LoadMarkdown(path string) (*Command, error)

LoadMarkdown loads a command from a markdown file with YAML frontmatter This is the Claude Code command format

func (*Command) InspectContent

func (c *Command) InspectContent() string

InspectContent returns the formatted content for the inspector viewport

func (*Command) InspectTitle

func (c *Command) InspectTitle() string

InspectTitle returns the display name for the inspector modal header

type MarkdownFrontmatter

type MarkdownFrontmatter struct {
	Name         string `yaml:"name"`
	Description  string `yaml:"description"`
	ArgumentHint string `yaml:"argument-hint"` // Codex-style argument hint
}

MarkdownFrontmatter represents the YAML frontmatter in a markdown command file

type ToolOverride

type ToolOverride struct {
	AllowedTools    []string `json:"allowedTools,omitempty"`
	DisallowedTools []string `json:"disallowedTools,omitempty"`
	AlwaysApply     bool     `json:"alwaysApply,omitempty"`
}

ToolOverride represents tool-specific command overrides