# How to use goose with Subconscious

> To use goose with Subconscious, add a custom OpenAI-compatible provider: run `goose configure` and choose Add A Custom Provider, or create `~/.config/goose/custom_providers/subconscious.json` pointing at Subconscious with the model `subconscious/glm-5.3-marathon`. Then start a session with `--provider subconscious`.

Canonical page: https://www.subconscious.dev/agents/agent-harnesses/goose
Category: [Agent harnesses](https://www.subconscious.dev/agents/agent-harnesses)
Last verified: 2026-09-30
goose: https://goose-docs.ai
Source: https://github.com/aaif-goose/goose

## Before you start

- A Subconscious account and API key

## Set up goose

### 1. Install the goose CLI

The desktop app works too: add the provider under Settings, Models, Configure providers.

```bash
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
```

### 2. Create a Subconscious API key

Sign in at https://platform.subconscious.dev, create an API key, and export it so the tool can read it.

```bash
export SUBCONSCIOUS_API_KEY="your_key"
```

### 3. Add Subconscious as a custom provider

goose's docs give custom providers the full chat completions URL. context_limit tells goose when to compact; 5,000,000 matches what the Subconscious CLI uses.

```json
{
  "name": "subconscious",
  "engine": "openai",
  "display_name": "Subconscious",
  "api_key_env": "SUBCONSCIOUS_API_KEY",
  "base_url": "https://api.subconscious.dev/v1/chat/completions",
  "models": [{ "name": "subconscious/glm-5.3-marathon", "context_limit": 5000000 }],
  "supports_streaming": true,
  "requires_auth": true
}
```

### 4. Start a session

Pass the provider name for one session, or pick it as the default in goose configure.

```bash
goose session start --provider subconscious
```

## Connection details

- OpenAI-compatible base URL: https://api.subconscious.dev/v1
- Anthropic-compatible base URL: https://api.subconscious.dev
- API key: From subc login or the Subconscious dashboard
- Model: subconscious/glm-5.3-marathon
- Multimodal, high-throughput model: subconscious/deepseek-v4.1-flash-marathon

Full API reference: https://docs.subconscious.dev

## Frequently asked questions

### Is goose still a Block project?

goose started at Block and now lives under the Agentic AI Foundation at the Linux Foundation, in the aaif-goose GitHub organization.

### Which Subconscious model should I use with goose?

Start with subconscious/glm-5.3-marathon, an open frontier coding model built for long agent runs. subconscious/deepseek-v4.1-flash-marathon is a cheaper, high-throughput alternative that also takes image input. Use the full model ID, including the subconscious/ prefix.

### Is goose on Subconscious OpenAI- or Anthropic-compatible?

This guide connects goose through the OpenAI-compatible Subconscious API. Subconscious serves both formats: OpenAI Chat Completions at https://api.subconscious.dev/v1 and Anthropic Messages at https://api.subconscious.dev.

### How is goose usage on Subconscious billed?

Per token by default, with no commitment. Heavy users can switch to a monthly token plan: a fixed price for a large daily token allowance shared across your team.