sage-cli 0.13.54

Command-line interface for Sage Agent
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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

//! CLI argument definitions using clap
//!
//! Unified CLI structure inspired by Claude Code:
//! - sage                     # Interactive mode (default)
//! - sage "task"              # Execute task interactively
//! - sage -p "task"           # Print mode (non-interactive, one-shot)
//! - sage -c                  # Resume most recent session
//! - sage -r <id>             # Resume specific session
//! - sage config/tools        # Utility commands

use crate::commands::unified::OutputModeArg;
use clap::{Parser, Subcommand};
use std::path::PathBuf;

/// Default configuration file name used across all CLI commands.
pub const DEFAULT_CONFIG_FILE: &str = "sage_config.json";

#[derive(Parser)]
#[command(name = "sage")]
#[command(about = "Sage Agent - LLM-based agent for software engineering tasks")]
#[command(
    long_about = r#"Sage Agent - LLM-based agent for software engineering tasks

USAGE:
  sage                           # Start interactive mode
  sage "your task"               # Execute task (interactive)
  sage -p "your task"            # Print mode (non-interactive)
  sage -c                        # Resume most recent session
  sage -r <session_id>           # Resume specific session

UTILITY COMMANDS:
  sage config init               # Create config file
  sage config show               # Show current config
  sage tools                     # List available tools

For detailed help: sage --help"#
)]
#[command(version)]
pub struct Cli {
    /// Task description to execute (omit for interactive prompt)
    pub task: Option<String>,

    /// Print mode - execute task and exit without interaction
    #[arg(short = 'p', long = "print")]
    pub print_mode: bool,

    /// Resume the most recent session
    #[arg(short = 'c', long = "continue", conflicts_with = "resume_session")]
    pub continue_session: bool,

    /// Resume a specific session by ID
    #[arg(short = 'r', long = "resume", conflicts_with = "continue_session")]
    pub resume_session: Option<String>,

    /// Maximum number of execution steps (unlimited if not specified)
    #[arg(long)]
    pub max_steps: Option<u32>,

    /// Path to configuration file
    #[arg(long, default_value = DEFAULT_CONFIG_FILE)]
    pub config_file: String,

    /// Working directory for the agent
    #[arg(long)]
    pub working_dir: Option<PathBuf>,

    /// Enable verbose output
    #[arg(long, short)]
    pub verbose: bool,

    /// Output in streaming JSON format (for SDK/programmatic use)
    #[arg(long)]
    pub stream_json: bool,

    /// Output mode: streaming (real-time), batch (collect then display), or silent
    #[arg(long, value_enum, default_value = "streaming")]
    pub output_mode: OutputModeArg,

    #[command(subcommand)]
    pub command: Option<Commands>,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Manage configuration files
    #[command(verbatim_doc_comment)]
    Config {
        #[command(subcommand)]
        action: ConfigAction,
    },

    /// List all available tools and their descriptions
    #[command(verbatim_doc_comment)]
    Tools,

    /// Check system health and diagnose issues (like Claude Code's /doctor)
    #[command(verbatim_doc_comment)]
    Doctor {
        /// Path to configuration file
        #[arg(long, default_value = DEFAULT_CONFIG_FILE)]
        config_file: String,
    },

    /// Show current status and environment info
    #[command(verbatim_doc_comment)]
    Status {
        /// Path to configuration file
        #[arg(long, default_value = DEFAULT_CONFIG_FILE)]
        config_file: String,
    },

    /// Show token usage statistics for sessions
    #[command(verbatim_doc_comment)]
    Usage {
        /// Path to session directory
        #[arg(long)]
        session_dir: Option<PathBuf>,

        /// Show detailed breakdown by session
        #[arg(long, short)]
        detailed: bool,
    },
}

#[derive(Subcommand, Clone)]
pub enum ConfigAction {
    /// Display current configuration settings
    Show {
        /// Path to configuration file
        #[arg(long, default_value = DEFAULT_CONFIG_FILE)]
        config_file: String,
    },

    /// Validate configuration file for errors
    Validate {
        /// Path to configuration file
        #[arg(long, default_value = DEFAULT_CONFIG_FILE)]
        config_file: String,
    },

    /// Create a new configuration file with defaults
    Init {
        /// Path for the new configuration file
        #[arg(long, default_value = DEFAULT_CONFIG_FILE)]
        config_file: String,

        /// Overwrite existing file without prompting
        #[arg(long)]
        force: bool,
    },
}