cli: Instructions file for Codex

AGENTS.md

Command pattern - always use RegisterCLICommand

All new commands must use the struct-based pattern. Do not copy the old flat var cmd = &cobra.Command{...} commands - they exist in cmd/storage/, cmd/dns/, cmd/dbaas/ and are legacy.

Read this file before writing any new command: cmd/aiservices/deployment/deployment_create.go

For subcommand placement in an existing group, also read ## Folder layout below.

Skeleton:

type myResourceCreateCmd struct {
    exocmd.CliCommandSettings `cli-cmd:"-"`

    _ bool `cli-cmd:"create"`

    Name string `cli-arg:"#"  cli-usage:"NAME"`        // required positional
    Tag  string `cli-arg:"?"  cli-usage:"TAG"`          // optional positional
    Zone string `cli-short:"z" cli-usage:"zone"`        // becomes --zone / -z flag
}

func (c *myResourceCreateCmd) CmdAliases() []string { return exocmd.GCreateAlias }
func (c *myResourceCreateCmd) CmdShort() string     { return "Create a resource" }
func (c *myResourceCreateCmd) CmdLong() string      { return "..." }

func (c *myResourceCreateCmd) CmdPreRun(cmd *cobra.Command, args []string) error {
    exocmd.CmdSetZoneFlagFromDefault(cmd)
    return exocmd.CliCommandDefaultPreRun(c, cmd, args)
}

func (c *myResourceCreateCmd) CmdRun(_ *cobra.Command, _ []string) error {
    // c.Name, c.Zone are already populated here
    return nil
}

func init() {
    cobra.CheckErr(exocmd.RegisterCLICommand(parentCmd, &myResourceCreateCmd{
        CliCommandSettings: exocmd.DefaultCLICmdSettings(),
    }))
}

Supported struct tags: