claude_runner_core 1.0.0

Claude Code process execution with builder pattern
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

# agents

Define custom agents inline as a JSON object for the current session.

## Type

**CLI** — JSON string value

## Syntax

```
claude --agents '<json>'
```

## Default

None (only configured agents available)

## Description

Defines one or more custom agents as a JSON object, available for the current session without needing to modify config files. Each agent has a name, description, and system prompt.

JSON format:
```json
{
  "agent-name": {
    "description": "What this agent does",
    "prompt": "System prompt for this agent"
  }
}
```

After defining agents with `--agents`, select one using `--agent <name>`.

## Builder API

Use `with_agents()` — Accepts a single JSON string defining multiple agents.

```rust
use claude_runner_core::ClaudeCommand;

let json = r#"[{"name":"reviewer","model":"claude-opus-4-6"}]"#;
let cmd = ClaudeCommand::new()
  .with_agents( json )
  .with_message( "Use custom agent config" );
```

## Examples

```bash
# Define and use a custom agent
claude \
  --agents '{"tester":{"description":"Writes tests","prompt":"You write comprehensive test suites. Follow TDD principles."}}' \
  --agent tester \
  --print "Write tests for src/auth.rs"

# Multiple agents defined
claude \
  --agents '{"reviewer":{"description":"Reviews","prompt":"Be critical"},"fixer":{"description":"Fixes","prompt":"Be helpful"}}' \
  --agent reviewer \
  --print "Review this"
```

## Notes

- JSON must be valid and properly shell-quoted
- Use single quotes around the JSON to avoid shell interpolation issues
- Agent names defined here override any identically-named agents in config files
- Combine with `--agent <name>` to select which defined agent to use