scud-cli 1.20.0

Fast, simple task master for AI-driven development
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

# LLM Provider Configuration

SCUD supports multiple LLM providers. You can configure your preferred provider during initialization or by editing the config file.

## Supported Providers

### xAI (Grok)
**Default Model:** `grok-code-fast-1`

```bash
# Initialize with xAI
scud init --provider xai

# Set API key
export XAI_API_KEY=your-xai-api-key
```

### Anthropic (Claude)
**Default Model:** `claude-sonnet-4-20250514`

```bash
# Initialize with Anthropic
scud init --provider anthropic

# Set API key
export ANTHROPIC_API_KEY=sk-ant-your-key
```

### OpenAI (GPT)
**Default Model:** `gpt-4-turbo`

```bash
# Initialize with OpenAI
scud init --provider openai

# Set API key
export OPENAI_API_KEY=sk-your-key
```

### OpenRouter
**Default Model:** `anthropic/claude-sonnet-4`

```bash
# Initialize with OpenRouter
scud init --provider openrouter

# Set API key
export OPENROUTER_API_KEY=sk-or-your-key
```

## Configuration File

The configuration is stored in `.taskmaster/config.toml`:

```toml
[llm]
provider = "xai"
model = "grok-code-fast-1"
max_tokens = 4096
```

## Changing Providers

To change providers after initialization:

1. Edit `.taskmaster/config.toml`
2. Update the `provider` and `model` fields
3. Set the appropriate API key environment variable

## Interactive Mode

If you don't specify a provider, SCUD will prompt you interactively:

```bash
scud init
# Select your LLM provider:
# > xAI (Grok)
#   Anthropic (Claude)
#   OpenAI (GPT)
#   OpenRouter
```

## API Endpoints

Each provider uses a different API endpoint:

- **xAI:** `https://api.x.ai/v1/chat/completions`
- **Anthropic:** `https://api.anthropic.com/v1/messages`
- **OpenAI:** `https://api.openai.com/v1/chat/completions`
- **OpenRouter:** `https://openrouter.ai/api/v1/chat/completions`

## Custom Models

You can override the default model by editing the config file:

```toml
[llm]
provider = "xai"
model = "grok-2-latest"  # Use a different model
max_tokens = 8192        # Increase token limit
```

## Environment Variables

SCUD reads API keys from environment variables for security:

| Provider | Environment Variable |
|----------|---------------------|
| xAI | `XAI_API_KEY` |
| Anthropic | `ANTHROPIC_API_KEY` |
| OpenAI | `OPENAI_API_KEY` |
| OpenRouter | `OPENROUTER_API_KEY` |

Set these in your shell profile (`.bashrc`, `.zshrc`, etc.) for persistence:

```bash
# Add to ~/.zshrc or ~/.bashrc
export XAI_API_KEY="your-key-here"
```

## Troubleshooting

### Authentication Error
```
Error: XAI_API_KEY environment variable not set
```

**Solution:** Set the appropriate API key for your provider.

### Invalid Provider
```
Error: Invalid provider: xxx. Valid options: xai, anthropic, openai, openrouter
```

**Solution:** Use one of the supported provider names.

### API Error
```
xai API error (401 Unauthorized): {"error": {"message": "Invalid API key"}}
```

**Solution:** Verify your API key is correct and has not expired.