Skip to main content

Goose

Goose is an AI agent platform supporting local and desktop environments with CLI capabilities. It automates engineering tasks like code generation, debugging, testing, and deployment through MCP protocol integration.

Features​

  • Code Generation: Generate code from natural language descriptions
  • Debugging: Identify and fix issues in your code
  • Testing: Create and run tests
  • Deployment: Automate deployment workflows
  • MCP Protocol: Enhanced functionality through MCP servers
  • Desktop App: Native desktop application with GUI

Installation​

Desktop Application​

Download Goose Desktop from the official website and install for your operating system.

CLI Installation​

Follow the installation instructions from the official Goose documentation for CLI setup.

Configuration for Apertis API​

Step 1: Open Provider Settings​

  1. Launch Goose Desktop
  2. Click the menu on the left sidebar
  3. Select "Create New Provider"

Step 2: Configure Anthropic-Compatible Provider​

Enter the following settings:

SettingValue
Provider TypeAnthropic Compatible
Base URLhttps://api.apertis.ai
API KeyYour Apertis API key

Step 3: Select Model​

Choose your preferred model:

ModelName
Claude Sonnet 4.5claude-sonnet-4.5
Claude Haiku 4.5claude-haiku-4.5
Claude Sonnet 4claude-sonnet-4.5
Claude Opus 4claude-opus-4-5-20251101

Step 4: Activate Provider​

  1. Return to the main interface
  2. Click "Switch Models" at the bottom
  3. Select your newly configured Apertis provider from the dropdown

Alternative: OpenAI-Compatible Configuration​

You can also configure Goose with OpenAI-compatible settings:

SettingValue
Provider TypeOpenAI Compatible
Base URLhttps://api.apertis.ai/v1
API KeyYour Apertis API key

This allows access to all models including GPT and Gemini variants.

Available Models​

ModelName
Claude Sonnet 4.5claude-sonnet-4.5
Claude Haiku 4.5claude-haiku-4.5
GPT-4ogpt-4.1
GPT-4o minigpt-4.1-mini
Gemini 3 Flashgemini-3-flash-preview

MCP Integration​

Goose supports Model Context Protocol servers for enhanced functionality:

  • Vision Server: Analyze images and visual content
  • Web Search Server: Search the web for information
  • Web Reader Server: Extract content from web pages

Capabilities​

Once configured, Goose can assist with:

  • Code Generation: Create code based on requirements
  • Debugging: Identify and fix bugs
  • Testing: Generate and run test suites
  • Deployment: Automate CI/CD workflows
  • Documentation: Generate project documentation
  • Refactoring: Improve code structure

Troubleshooting​

Provider Not Working​

  • Verify your API key at Apertis Dashboard
  • Check the Base URL is correct for your provider type
  • Try switching between Anthropic and OpenAI compatible modes

Connection Issues​

  • Check your network connection
  • Verify firewall settings allow connections
  • Ensure the API key is valid and has sufficient quota