adk-cli 0.1.8

Command-line launcher for Rust Agent Development Kit (ADK-Rust) agents
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

# adk-cli

Command-line launcher for Rust Agent Development Kit (ADK-Rust) agents.

[![Crates.io](https://img.shields.io/crates/v/adk-cli.svg)](https://crates.io/crates/adk-cli)
[![Documentation](https://docs.rs/adk-cli/badge.svg)](https://docs.rs/adk-cli)
[![License](https://img.shields.io/crates/l/adk-cli.svg)](LICENSE)

## Overview

`adk-cli` provides command-line tools for the Rust Agent Development Kit ([ADK-Rust](https://github.com/zavora-ai/adk-rust)):

- **Launcher** - Interactive REPL for agent conversations
- **Server Mode** - HTTP server with web UI
- **Session Management** - Automatic session handling
- **Telemetry** - Integrated logging and tracing

## Installation

```toml
[dependencies]
adk-cli = "0.1.8"
```

Or use the meta-crate:

```toml
[dependencies]
adk-rust = { version = "0.1.8", features = ["cli"] }
```

## Quick Start

### Interactive Mode

```rust
use adk_cli::Launcher;
use std::sync::Arc;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let agent = create_your_agent()?;

    // Start interactive REPL
    Launcher::new(Arc::new(agent))
        .run()
        .await?;

    Ok(())
}
```

### Server Mode

```rust
Launcher::new(Arc::new(agent))
    .with_server_mode(8080)
    .run()
    .await?;

// Open http://localhost:8080 for web UI
```

### Custom Configuration

```rust
Launcher::new(Arc::new(agent))
    .with_user_id("user_123")
    .with_session_id("session_456")
    .with_artifact_service(Arc::new(artifacts))
    .run()
    .await?;
```

## CLI Commands

When running in interactive mode:

| Command | Description |
|---------|-------------|
| Type message | Send to agent |
| `/quit` or `/exit` | Exit REPL |
| `/clear` | Clear conversation |
| Ctrl+C | Interrupt |

## Environment Variables

```bash
# Logging level
RUST_LOG=info

# API key (for Gemini)
GOOGLE_API_KEY=your-key
```

## Features

- Colored output with streaming
- History support (arrow keys)
- Graceful shutdown
- Error recovery

## Binary Installation

The `adk` binary is also available:

```bash
cargo install adk-cli

# Run your agent
adk --help
```

## Related Crates

- [adk-rust](https://crates.io/crates/adk-rust) - Meta-crate with all components
- [adk-server](https://crates.io/crates/adk-server) - HTTP server
- [adk-runner](https://crates.io/crates/adk-runner) - Execution runtime

## License

Apache-2.0

## Part of ADK-Rust

This crate is part of the [ADK-Rust](https://adk-rust.com) framework for building AI agents in Rust.