csess 0.8.1

Fast lister for Claude Code sessions in a folder and its subprojects
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

use crate::filter::SortKey;
use clap::Parser;

// `--version` reports the Claude Code version this release was tested against.
// Bump the literal below each release to the `version` field seen in recent
// session .jsonl files — lets us pin format drift if a future Claude Code
// release breaks parsing.
#[derive(Parser, Debug)]
#[command(
    name = "csess",
    version = concat!(
        env!("CARGO_PKG_VERSION"),
        " (verified with Claude Code 2.1.202)"
    ),
    about = "List Claude Code sessions for a folder and its subprojects"
)]
pub struct Cli {
    /// Folder to scan (default: current directory)
    pub path: Option<String>,

    /// List sessions across all Claude projects
    #[arg(short = 'g', long)]
    pub global: bool,

    /// Only the exact folder (default also scans subfolders)
    #[arg(short = 'R', long = "no-recursive")]
    pub no_recursive: bool,

    /// Fuzzy match on session name / path
    #[arg(short = 's', long)]
    pub search: Option<String>,

    /// Print the full transcript of one session (by id, short id, or name)
    #[arg(long, value_name = "ID_OR_NAME")]
    pub show: Option<String>,

    /// With --show: only messages older than this message uuid (scroll-up cursor)
    #[arg(long, value_name = "UUID", requires = "show")]
    pub before: Option<String>,

    /// Only this role's messages (applies to --show and --grep)
    #[arg(long, value_enum, value_name = "ROLE")]
    pub role: Option<Role>,

    /// Search message text: with --show filters that transcript, else scans across sessions
    #[arg(long, value_name = "TEXT")]
    pub grep: Option<String>,

    /// Lower time bound: 2026-06-01 | 7d | 24h | 30m
    #[arg(long)]
    pub since: Option<String>,

    /// Upper time bound (same formats)
    #[arg(long)]
    pub until: Option<String>,

    /// today | yesterday | week | month
    #[arg(long)]
    pub period: Option<String>,

    /// Sort key (default: active)
    #[arg(long, value_enum)]
    pub sort: Option<SortKey>,

    /// Reverse sort order
    #[arg(short = 'r', long)]
    pub reverse: bool,

    /// Limit number of results
    #[arg(short = 'n', long)]
    pub limit: Option<usize>,

    /// Session-list cursor: only sessions after this id in sort order (lazy-load next page)
    #[arg(long, value_name = "ID", conflicts_with = "show")]
    pub after: Option<String>,

    /// Machine-readable JSON output
    #[arg(long)]
    pub json: bool,

    /// Override projects root (for testing)
    #[arg(long, hide = true)]
    pub projects_dir: Option<String>,
}

/// Message role, for `--role`.
#[derive(clap::ValueEnum, Clone, Copy, Debug)]
pub enum Role {
    User,
    Assistant,
}

impl Role {
    pub fn as_str(self) -> &'static str {
        match self {
            Role::User => "user",
            Role::Assistant => "assistant",
        }
    }
}