Goose is an open-source AI coding assistant from Block (Square). It runs in your terminal and can autonomously write code, run commands, and manage files.Documentation Index
Fetch the complete documentation index at: https://docs.infercom.ai/llms.txt
Use this file to discover all available pages before exploring further.
Setup time: ~5 minutes
Prerequisites
- macOS with Homebrew, or Linux
- Infercom API key
Installation
Configuration
Option 1: Custom Provider (Recommended)
Create a custom provider file for Infercom.Step 1: Create Provider Directory
Step 2: Create Provider File
Create~/.config/goose/custom_providers/infercom.json:
Step 3: Set API Key
~/.bashrc, ~/.zshrc) for persistence.
Step 4: Configure Goose
Option 2: OpenAI Compatible
Use the built-in OpenAI provider with custom endpoint:goose configure and select OpenAI.
Model
UseMiniMax-M2.7 - optimized for agentic coding with 192K context and tool calling support.
Usage
Interactive Session
Non-Interactive
Useful Commands
| Command | Description |
|---|---|
goose configure | Configure providers and models |
goose session | Start interactive session |
goose run --text "..." | Non-interactive execution |
goose info | Show configuration paths |
Configuration Paths
| Item | Path |
|---|---|
| Config file | ~/.config/goose/config.yaml |
| Custom providers | ~/.config/goose/custom_providers/ |
| Sessions | ~/.local/share/goose/sessions/ |
| Logs | ~/.local/state/goose/logs/ |
Troubleshooting
Provider Not Showing
- Verify the JSON file is valid:
- Check the file location is correct
- Re-run
goose configure
Authentication Failed
Verify your API key is set:Tool Calling Errors
MiniMax-M2.7 supports tool calling. If you see errors:- Ensure you’re using
MiniMax-M2.7(not other models) - Check the model configuration includes
"supports_tool_calling": true
Next Steps
- Aider - Simpler terminal tool
- OpenCode - Terminal TUI alternative
- Choosing a Tool - Compare all options