claudecode 0.1.17

A Rust SDK for programmatically interacting with Claude Code
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

//! # ClaudeCode-RS
//!
//! A Rust SDK for programmatically interacting with Claude Code.
//!
//! ## Quick Start
//!
//! ```rust,no_run
//! use claudecode::{Client, SessionConfig, Model, OutputFormat};
//!
//! #[tokio::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//!     // Create a client
//!     let client = Client::new().await?;
//!     
//!     // Simple query
//!     let config = SessionConfig::builder("Hello, Claude!")
//!         .model(Model::Sonnet)
//!         .build()?;
//!     
//!     let result = client.launch_and_wait(config).await?;
//!     println!("Claude says: {}", result.content.unwrap_or_default());
//!     
//!     Ok(())
//! }
//! ```
//!
//! ## Streaming Events
//!
//! ```rust,no_run
//! use claudecode::{Client, SessionConfig, OutputFormat, Event};
//! use futures::StreamExt;
//!
//! #[tokio::main]
//! async fn main() -> Result<(), Box<dyn std::error::Error>> {
//!     let client = Client::new().await?;
//!     
//!     let config = SessionConfig::builder("Tell me a story")
//!         .output_format(OutputFormat::StreamingJson)
//!         .build()?;
//!     
//!     let mut session = client.launch(config).await?;
//!     
//!     // Process streaming events with type-safe pattern matching
//!     if let Some(mut events) = session.take_event_stream() {
//!         while let Some(event) = events.recv().await {
//!             match event {
//!                 Event::Assistant(msg) => {
//!                     println!("Claude: {:?}", msg.message.content);
//!                 }
//!                 Event::Result(result) => {
//!                     println!("Total cost: ${:?}", result.total_cost_usd);
//!                 }
//!                 _ => {}
//!             }
//!         }
//!     }
//!     
//!     let result = session.wait().await?;
//!     Ok(())
//! }
//! ```

#[cfg(not(unix))]
compile_error!(
    "claudecode_rs only supports Unix-like platforms (Linux/macOS). Windows is not supported."
);

pub mod client;
pub mod config;
pub mod error;
pub mod mcp;
pub mod probe;
pub mod process;
pub mod session;
pub mod stream;
pub mod types;

// Re-export main types
pub use client::Client;
pub use config::MCPConfig;
pub use config::MCPServer;
pub use config::SessionConfig;
pub use config::SessionConfigBuilder;
pub use error::ClaudeError;
pub use error::Result;
pub use probe::CliCapabilities;
pub use session::Session;
pub use types::AssistantEvent;
pub use types::Content;
pub use types::ErrorEvent;
pub use types::Event;
pub use types::InputFormat;
pub use types::MCPStatus;
pub use types::Message;
pub use types::Model;
pub use types::OutputFormat;
pub use types::PermissionMode;
pub use types::Result as ClaudeResult;
pub use types::ResultEvent;
pub use types::ServerToolUse;
pub use types::SystemEvent;
pub use types::Usage;

// Version information
pub const VERSION: &str = env!("CARGO_PKG_VERSION");