Add Model

Add Model Skill

Add a new AI model to the aico codebase.

Arguments

$ARGUMENTS should be in the format provider:model-id (e.g. anthropic:claude-opus-4-6). If only a model ID is given, infer the provider from the model name prefix:

• claude-* → anthropic
• gpt-*, o1*, o3* → openai
• llama*, mixtral* → groq
• Other → ask the user

Prerequisite: Gather Model Information

Before writing any code, gather the following from the user or from provided reference URLs:

1. Model ID (e.g. claude-opus-4-6)
2. Description - what the model is best at
3. Pricing - input/output per MTok
4. Context window and max output tokens
5. Notable capabilities (e.g. extended thinking, vision, tool calling)
6. Predecessor model to deprecate (optional)

If the user provides a reference URL, fetch it to extract this information.

Provider Reference URLs

When the user does not provide a reference URL, consult the official documentation for the relevant provider:

Fetch the relevant page(s) to extract:

• The exact model ID string used in API calls
• Context window size and max output tokens
• Input/output pricing per million tokens
• Release date and predecessor model (if applicable)
• Special capabilities or limitations

Step-by-step Procedure

1. Create the model Go file

Create a new file at internal/providers/<provider>/<model_file_name>.go.

The file name convention uses underscores for separators:

• claude-opus-4-6 → claude_opus_4_6.go
• gpt-4o → gpt4o.go
• llama-3.3-70b-versatile → llama3_3_70b.go

Use the existing model files in the same provider as a template. Each provider has a different pattern:

Anthropic models (internal/providers/anthropic/)

• Uses github.com/anthropics/anthropic-sdk-go SDK
• Struct has client *anthropic.Client and opts []anthropicopt.RequestOption
• Constructor takes *anthropic.Client
• Uses buildRequestBody() helper and m.client.Messages.New() / m.client.Messages.NewStreaming()
• Must define a ModelName constant: const ModelNameXxx = "model-id"

Template reference: any existing claude_*.go file in the same directory.

OpenAI models (internal/providers/openai/)

• Uses the in-house openai.APIClient
• Constructor takes apiKey string
• Uses BuildChatRequest() and m.client.DoPost() / m.client.DoStream()

Template reference: gpt4o.go

Groq / Cerebras models (OpenAI-compatible)

• Uses openai.APIClient from the openai package
• Constructor takes apiKey string
• Delegates to openai.GenerateContent() / openai.GenerateContentStream() with the provider's Endpoint

Template reference: any model file in internal/providers/groq/ or internal/providers/cerebras/

2. Register the model in the provider file

Edit the provider's main file (internal/providers/<provider>/<provider>.go or anthropic.go):

1. AvailableModels() - Add the new model struct to the returned slice
2. selectModel() - Add a case for the model ID
3. NewGenerativeModel() - Add a case for the model ID with the constructor

Place the new model at an appropriate position (typically at the top for the latest/best model).

3. Update the doc comment

Update the documentation comment block at the top of the provider file to include the new model's description and pricing.

4. Deprecate predecessor (if requested)

If the user requests deprecating an older model:

1. Prefix its Description() return with [Deprecated] <Model Name> - superseded by <New Model>.
2. Move its entry in the doc comment to the bottom with (Deprecated) suffix
3. Keep all code functional — do NOT remove the model

5. Build and test

Run:

go build ./...
go test ./...

6. Verify with CLI

Run and show the user the output of:

go run ./cmd/aico models
go run ./cmd/aico models describe <new-model-id>

If a predecessor was deprecated, also show:

go run ./cmd/aico models describe <deprecated-model-id>

7. Commit

Follow the Conventional Commits format defined in CLAUDE.md:

feat(api): add <Model Name> support

If a predecessor was deprecated, mention it:

feat(api): add <Model Name> support and deprecate <Old Model>