oc-session 0.1.0

Global OpenCode session browser and resume tool
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

use clap::{Args, Parser, Subcommand};
use std::path::PathBuf;

#[derive(Parser)]
#[command(name = "oc-session")]
#[command(about = "Global OpenCode session browser and resume tool")]
#[command(version)]
#[command(
    after_help = "Examples:\n  oc-session\n  oc-session --search project\n  oc-session search \"session recovery\"\n  oc-session recent --limit 20\n  oc-session print ses_abc123\n  oc-session copy ses_abc123\n  oc-session doctor"
)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Option<Command>,

    #[arg(short, long, global = true, help = "Path to config.toml")]
    pub config: Option<PathBuf>,

    #[arg(
        short,
        long,
        value_name = "QUERY",
        help = "Open the picker filtered by keywords"
    )]
    pub search: Option<String>,

    #[arg(long, global = true, help = "Include OpenCode child/subagent sessions")]
    pub include_children: bool,
}

#[derive(Subcommand)]
pub enum Command {
    #[command(about = "Search sessions and open the picker")]
    Search(SearchArgs),
    #[command(about = "Print recent sessions")]
    Recent(RecentArgs),
    #[command(about = "Resume or print the latest session")]
    Last(LastArgs),
    #[command(about = "Resume a session by id")]
    Resume(ResumeArgs),
    #[command(about = "Print the resume command for a session")]
    Print(PrintArgs),
    #[command(about = "Copy the resume command for a session")]
    Copy(CopyArgs),
    #[command(about = "Scan the home directory for OpenCode databases")]
    Scan(ScanArgs),
    #[command(about = "Show discovery and database diagnostics")]
    Doctor,
    #[command(about = "Manage the bundled OpenCode agent skill")]
    Skill(SkillArgs),
}

#[derive(Args)]
pub struct SkillArgs {
    #[command(subcommand)]
    pub command: SkillCommand,
}

#[derive(Subcommand)]
pub enum SkillCommand {
    #[command(about = "Install the bundled skill into OpenCode")]
    Install(SkillInstallArgs),
    #[command(about = "Print the bundled skill contents")]
    Print,
    #[command(about = "Print the OpenCode skill install path")]
    Path,
}

#[derive(Args)]
pub struct SkillInstallArgs {
    #[arg(long, help = "Overwrite an existing installed skill")]
    pub force: bool,
}

#[derive(Args)]
pub struct SearchArgs {
    #[arg(help = "Keywords to search for")]
    pub query: Vec<String>,

    #[arg(short, long, default_value_t = 100, help = "Maximum sessions to show")]
    pub limit: usize,

    #[arg(long, help = "Print results instead of opening the picker")]
    pub no_tui: bool,
}

#[derive(Args)]
pub struct RecentArgs {
    #[arg(
        short,
        long,
        default_value_t = 50,
        value_name = "N",
        help = "Maximum sessions to print"
    )]
    pub limit: usize,

    #[arg(long, help = "Output machine-readable JSON")]
    pub json: bool,
}

#[derive(Args)]
pub struct LastArgs {
    #[arg(long, help = "Print the resume command instead of running it")]
    pub print: bool,
}

#[derive(Args)]
pub struct ResumeArgs {
    #[arg(value_name = "SESSION_ID", help = "OpenCode session id")]
    pub id: String,
}

#[derive(Args)]
pub struct PrintArgs {
    #[arg(value_name = "SESSION_ID", help = "OpenCode session id")]
    pub id: String,
}

#[derive(Args)]
pub struct CopyArgs {
    #[arg(value_name = "SESSION_ID", help = "OpenCode session id")]
    pub id: String,
}

#[derive(Args)]
pub struct ScanArgs {
    #[arg(
        long,
        value_name = "PATH",
        help = "Additional directory or database path to scan"
    )]
    pub include: Vec<PathBuf>,
}