clawdb 0.1.2

The cognitive database for AI agents — unified memory, semantic retrieval, branching, sync, and governance.
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

//! ClawDB command-line entry point.

use clap::{Parser, Subcommand};
use clawdb::lifecycle::GracefulShutdown;
use clawdb::telemetry::init_tracing;
use clawdb::{ClawDBConfig, ClawDBEngine};

#[derive(Parser)]
#[command(name = "clawdb", about = "ClawDB – the agent memory database", version)]
struct Cli {
    /// Path to the data directory.
    #[arg(long, env = "CLAW_DATA_DIR")]
    data_dir: Option<std::path::PathBuf>,

    #[command(subcommand)]
    command: Command,
}

#[derive(Subcommand)]
enum Command {
    /// Start the ClawDB gRPC server.
    Serve {
        /// gRPC listen port.
        #[arg(long, default_value = "50050")]
        port: u16,
    },
    /// Print the current health status and exit.
    Health,
    /// Print the default configuration and exit.
    Config,
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let cli = Cli::parse();

    let data_dir = cli
        .data_dir
        .unwrap_or_else(|| dirs::home_dir().unwrap_or_default().join(".clawdb"));

    let config = ClawDBConfig::load_or_default(&data_dir)?;
    init_tracing(&config.log_level, &config.log_format);

    match cli.command {
        Command::Serve { port: _ } => {
            tracing::info!("Starting ClawDB engine…");
            let engine = ClawDBEngine::start_with(config).await?;
            let shutdown = GracefulShutdown::new(30);
            shutdown.wait_for_signal().await;
            engine.shutdown().await?;
            tracing::info!("ClawDB stopped cleanly");
        }
        Command::Health => {
            let engine = ClawDBEngine::start_with(config).await?;
            let report = engine.health().await?;
            println!("{}", serde_json::to_string_pretty(&report)?);
            engine.shutdown().await?;
        }
        Command::Config => {
            let raw = toml::to_string_pretty(&config).unwrap_or_default();
            println!("{raw}");
        }
    }

    Ok(())
}