appctl 0.5.0

One command. Any app. Full AI control. The universal AI CLI for any web app, database, or service.
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

use anyhow::Result;
use tokio::sync::mpsc;
use uuid::Uuid;

use crate::{
    ai::run_agent,
    config::{AppConfig, ConfigPaths},
    executor::ExecutionContext,
    safety::SafetyMode,
    sync::{load_schema, load_tools},
};

#[derive(Debug, Clone)]
pub struct RunOptions {
    pub prompt: String,
    pub provider: Option<String>,
    pub model: Option<String>,
    pub read_only: bool,
    pub dry_run: bool,
    pub confirm: bool,
    pub strict: bool,
}

pub async fn run_once(
    paths: &ConfigPaths,
    config: &AppConfig,
    app_name: &str,
    options: RunOptions,
) -> Result<()> {
    let schema = load_schema(paths)?;
    let tools = load_tools(paths)?;
    let context = crate::term::chat_context(app_name, &config.default, options.provider.as_deref());
    crate::term::print_chat_banner(&context, &paths.root, schema.resources.len(), tools.len());
    let (tx, rx) = mpsc::channel(64);
    let printer = tokio::spawn(crate::term::run_event_printer(rx));
    let response = run_agent(
        paths,
        config,
        options.provider.as_deref(),
        options.model.as_deref(),
        &options.prompt,
        &[],
        &tools,
        &schema,
        ExecutionContext {
            session_id: Uuid::new_v4().to_string(),
            safety: SafetyMode {
                read_only: options.read_only,
                dry_run: options.dry_run,
                confirm: options.confirm,
                strict: options.strict,
            },
        },
        Some(tx),
    )
    .await;
    let _ = printer.await;
    let response = response?.response;

    if let Some(text) = response.as_str()
        && text.contains('?')
    {
        crate::term::print_tip(
            "`appctl run` is one-shot — use `appctl chat` for follow-up conversation.",
        );
    }

    if !matches!(response, serde_json::Value::String(_)) {
        crate::term::print_json_pretty_value(&response);
    }
    Ok(())
}