cmd

package
v0.0.82 Latest Latest
Warning

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

 Go to latest Published: Feb 18, 2026 License: MIT Imports: 69 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var Commit = "unknown"
View Source 
var Date = "unknown"
View Source 
var Version = "dev"

These will be set by the linker during build

Functions

func AddAgentFlag added in v0.0.34 

func AddAgentFlag(cmd *cobra.Command, dest *string)

AddAgentFlag adds the --agent/-a flag with completion

func AddDebugFlag added in v0.0.34 

func AddDebugFlag(cmd *cobra.Command, dest *bool)

AddDebugFlag adds the --debug/-d flag

func AddFileFlag added in v0.0.34 

func AddFileFlag(cmd *cobra.Command, dest *[]string, description string)

AddFileFlag adds the --file/-f flag

func AddMCPFlag added in v0.0.34 

func AddMCPFlag(cmd *cobra.Command, dest *string)

AddMCPFlag adds the --mcp flag with completion

func AddMaxTurnsFlag added in v0.0.34 

func AddMaxTurnsFlag(cmd *cobra.Command, dest *int, defaultValue int)

AddMaxTurnsFlag adds the --max-turns flag

func AddNativeSearchFlags added in v0.0.34 

func AddNativeSearchFlags(cmd *cobra.Command, native, noNative *bool)

AddNativeSearchFlags adds --native-search and --no-native-search flags

func AddProviderFlag added in v0.0.34 

func AddProviderFlag(cmd *cobra.Command, dest *string)

AddProviderFlag adds the --provider/-p flag with completion

func AddSearchFlag added in v0.0.34 

func AddSearchFlag(cmd *cobra.Command, dest *bool)

AddSearchFlag adds the --search/-s flag

func AddSkillsFlag added in v0.0.37 

func AddSkillsFlag(cmd *cobra.Command, dest *string)

AddSkillsFlag adds the --skills flag with completion Values: "all" or "*" to enable all, "none" to disable, skill names (comma-separated), or skill,+ for explicit + auto

func AddSystemMessageFlag added in v0.0.34 

func AddSystemMessageFlag(cmd *cobra.Command, dest *string)

AddSystemMessageFlag adds the --system-message/-m flag

func AddToolFlags added in v0.0.34 

func AddToolFlags(cmd *cobra.Command, tools *string, readDirs, writeDirs, shellAllow *[]string)

AddToolFlags adds tool-related flags (--tools, --read-dir, --write-dir, --shell-allow)

func AddYoloFlag added in v0.0.35 

func AddYoloFlag(cmd *cobra.Command, dest *bool)

AddYoloFlag adds the --yolo flag for auto-approving all tool operations

func AgentFlagCompletion added in v0.0.33 

func AgentFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

AgentFlagCompletion provides shell completion for the --agent flag.

func AgentFlagCompletionWithPaths added in v0.0.65 

func AgentFlagCompletionWithPaths(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

AgentFlagCompletionWithPaths provides shell completion for the --agent flag. Returns agent names for plain strings, or falls back to directory completion when the input looks like a path.

func AtAgentCompletion added in v0.0.33 

func AtAgentCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

AtAgentCompletion provides completions for @agent syntax in positional args. When typing "@<TAB>", completes to "@agent-builder", "@commit", etc.

func Execute 

func Execute()

func ExtractAgentFromArgs added in v0.0.33 

func ExtractAgentFromArgs(args []string) (agentName string, filteredArgs []string)

ExtractAgentFromArgs checks args for @agent-name syntax and returns the agent name and filtered args. Returns empty string if no @agent found.

func ImageProviderFlagCompletion added in v0.0.6 

func ImageProviderFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

ImageProviderFlagCompletion handles --provider flag completion for image commands

func InitSessionStore added in v0.0.46 

func InitSessionStore(cfg *config.Config, errWriter io.Writer) (session.Store, func())

InitSessionStore creates a session store if enabled in config. Returns the store (may be nil if disabled) and a cleanup function. The cleanup function is always safe to call (handles nil store). Warnings are written to errWriter.

func LoadAgent added in v0.0.34 

func LoadAgent(agentName string, cfg *config.Config) (*agents.Agent, error)

LoadAgent loads and validates an agent by name or path. Returns nil if agentName is empty. If agentName contains a path separator, it is loaded directly from the filesystem. Otherwise, it is looked up in the agent registry.

func MCPFlagCompletion added in v0.0.15 

func MCPFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

MCPFlagCompletion provides completions for --mcp flag with comma-separated support. When typing "playwright,file<TAB>", completes to "playwright,filesystem".

func MCPRunArgCompletion added in v0.0.64 

func MCPRunArgCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

MCPRunArgCompletion provides completions for "mcp run <server> <tool> [key=val] ...". Completes server names for the first arg, tool names and key= params for subsequent args. Tool/param data comes from a local cache populated by "mcp info" and "mcp run".

func MCPServerArgCompletion added in v0.0.23 

func MCPServerArgCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

MCPServerArgCompletion provides completions for MCP server names as positional arguments. Used by commands like "mcp info <server>", "mcp run <server>" and "mcp remove <server>".

func ProviderFlagCompletion added in v0.0.6 

func ProviderFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

ProviderFlagCompletion handles --provider flag completion for LLM commands

func SetupSkills added in v0.0.46 

func SetupSkills(cfg *config.SkillsConfig, skillsFlag string, errWriter io.Writer) *skills.Setup

SetupSkills initializes the skills system if enabled. Returns the setup (may be nil) and logs warnings to errWriter on errors.

func SkillFlagCompletion added in v0.0.37 

func SkillFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

SkillFlagCompletion provides shell completion for skill-related flags.

func SkillsFlagCompletion added in v0.0.37 

func SkillsFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

SkillsFlagCompletion provides shell completion for the --skills flag.

func ToolsFlagCompletion added in v0.0.25 

func ToolsFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

ToolsFlagCompletion provides completions for --tools flag with comma-separated support. When typing "read_file,wr<TAB>", completes to "read_file,write_file".

func UsageProviderFlagCompletion added in v0.0.34 

func UsageProviderFlagCompletion(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

UsageProviderFlagCompletion handles --provider flag completion for the usage command. Returns the specific providers that the usage command supports.

func WireSpawnAgentRunner added in v0.0.35 

func WireSpawnAgentRunner(cfg *config.Config, toolMgr *tools.ToolManager, yoloMode bool) error

WireSpawnAgentRunner sets up the spawn_agent runner if the tool is enabled. This should be called after SetupToolManager. The toolMgr's ApprovalMgr is passed to sub-agents so they inherit session approvals and can use the parent's prompt function for interactive approvals.

func WireSpawnAgentRunnerWithStore added in v0.0.46 

func WireSpawnAgentRunnerWithStore(cfg *config.Config, toolMgr *tools.ToolManager, yoloMode bool, store session.Store, parentSessionID string) error

WireSpawnAgentRunnerWithStore sets up the spawn_agent runner with session tracking. store is used to save subagent turns, parentSessionID links child sessions to parent.

Types

type CLIFlags added in v0.0.34 

type CLIFlags struct {
	Provider      string
	Tools         string
	ReadDirs      []string
	WriteDirs     []string
	ShellAllow    []string
	MCP           string
	SystemMessage string
	MaxTurns      int
	MaxTurnsSet   bool // true if --max-turns was explicitly set
	Search        bool
	Files         []string // files passed via -f flag, used for agent template expansion (e.g., {{.Files}})
}

CLIFlags holds the CLI flag values that can override settings.

type CommonFlags added in v0.0.34 

type CommonFlags struct {
	Provider       *string
	Debug          *bool
	MCP            *string
	Tools          *string
	ReadDirs       *[]string
	WriteDirs      *[]string
	ShellAllow     *[]string
	SystemMessage  *string
	Search         *bool
	NativeSearch   *bool
	NoNativeSearch *bool
	MaxTurns       *int
	Files          *[]string
	Agent          *string
}

CommonFlags holds pointers to flag variables shared across commands. Each command creates its own instance with its own variables.

type MCPOptions added in v0.0.39 

type MCPOptions struct {
	Provider llm.Provider
	Model    string
	YoloMode bool
}

MCPOptions contains options for enabling MCP servers.

type ModelLister added in v0.0.8 

type ModelLister interface {
	ListModels(ctx context.Context) ([]llm.ModelInfo, error)
}

ModelLister is an interface for providers that can list available models

type ProviderInfo added in v0.0.32 

type ProviderInfo struct {
	Name               string   `json:"name"`
	Type               string   `json:"type"`
	Credential         string   `json:"credential"`        // "api_key", "oauth", "none"
	EnvVar             string   `json:"env_var,omitempty"` // Environment variable for API key
	RequiresKey        bool     `json:"requires_key"`      // Whether API key is required
	SupportsListModels bool     `json:"supports_list_models"`
	Models             []string `json:"models,omitempty"` // Curated model list
	Configured         bool     `json:"configured"`       // Whether provider is in user config
	IsBuiltin          bool     `json:"is_builtin"`       // Whether this is a built-in provider
}

ProviderInfo describes a provider for external consumption

type SessionSettings added in v0.0.34 

type SessionSettings struct {
	// Provider/model
	Provider string
	Model    string

	// Tool settings
	Tools        string
	ReadDirs     []string
	WriteDirs    []string
	ShellAllow   []string
	ShellAutoRun bool
	Scripts      []string

	// Agent directory (for run_agent_script tool)
	AgentDir string

	// MCP servers (comma-separated)
	MCP string

	// System prompt (already expanded)
	SystemPrompt string

	// Behavior
	MaxTurns int
	Search   bool
}

SessionSettings holds the resolved settings for a session, merged from config defaults, agent settings, and CLI flags.

func ResolveSettings added in v0.0.34 

func ResolveSettings(cfg *config.Config, agent *agents.Agent, cli CLIFlags, configProvider, configModel, configInstructions string, configMaxTurns, defaultMaxTurns int) SessionSettings

ResolveSettings merges config, agent, and CLI flags into final settings. Priority: CLI > agent > config

func (*SessionSettings) SetupToolManager added in v0.0.34 

func (s *SessionSettings) SetupToolManager(cfg *config.Config, engine *llm.Engine) (*tools.ToolManager, error)

SetupToolManager creates and configures a ToolManager from settings. Returns nil if no tools are enabled.

type SpawnAgentRunner added in v0.0.35 

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

SpawnAgentRunner implements the tools.SpawnAgentRunner interface. It loads and runs sub-agents for the spawn_agent tool.

func NewSpawnAgentRunner added in v0.0.35 

func NewSpawnAgentRunner(cfg *config.Config, yoloMode bool, parentApprovalMgr *tools.ApprovalManager) (*SpawnAgentRunner, error)

NewSpawnAgentRunner creates a new SpawnAgentRunner. parentApprovalMgr enables sub-agents to inherit parent's session approvals and prompting.

func NewSpawnAgentRunnerWithStore added in v0.0.46 

func NewSpawnAgentRunnerWithStore(cfg *config.Config, yoloMode bool, parentApprovalMgr *tools.ApprovalManager, store session.Store, parentSessionID string) (*SpawnAgentRunner, error)

NewSpawnAgentRunnerWithStore creates a new SpawnAgentRunner with session tracking. store is used to save subagent turns, parentSessionID links child sessions to parent.

func (*SpawnAgentRunner) RunAgent added in v0.0.35 

func (r *SpawnAgentRunner) RunAgent(ctx context.Context, agentName string, prompt string, depth int) (tools.SpawnAgentRunResult, error)

RunAgent loads and runs a sub-agent with the given prompt. It returns the text output from the agent.

func (*SpawnAgentRunner) RunAgentWithCallback added in v0.0.42 

func (r *SpawnAgentRunner) RunAgentWithCallback(ctx context.Context, agentName string, prompt string, depth int,
	callID string, cb tools.SubagentEventCallback) (tools.SpawnAgentRunResult, error)

RunAgentWithCallback loads and runs a sub-agent with an event callback for progress reporting.

func (*SpawnAgentRunner) SetWarnFunc added in v0.0.46 

func (r *SpawnAgentRunner) SetWarnFunc(fn func(format string, args ...any))

SetWarnFunc sets a function to be called when non-fatal warnings occur (e.g., session persistence failures). If not set, warnings are logged via log.Printf.

type ToolDefinition added in v0.0.25 

type ToolDefinition struct {
	Name        string          `json:"name"`
	Description string          `json:"description"`
	Schema      json.RawMessage `json:"schema"`
}

ToolDefinition represents a tool definition passed to the MCP server

Source Files

View all Source files

Directories

Path Synopsis
Standalone test binary to debug image rendering with streaming markdown
 Standalone test binary to debug image rendering with streaming markdown
Package udiff provides parsing and application of unified diffs with elision support.
 Package udiff provides parsing and application of unified diffs with elision support.

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.