vtcode 0.99.1

A Rust-based terminal coding agent with modular architecture supporting multiple LLM providers
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

use std::path::Path;

#[derive(Debug, Clone)]
pub(super) struct TraditionalSkillRow {
    pub(super) status: &'static str,
    pub(super) name: String,
    pub(super) description: String,
}

#[derive(Debug, Clone)]
pub(super) struct CliToolRow {
    pub(super) name: String,
    pub(super) description: String,
    pub(super) path: String,
}

#[derive(Debug, Clone)]
pub(super) struct BuiltInSkillRow {
    pub(super) name: String,
    pub(super) description: String,
    pub(super) usage: String,
}

#[derive(Debug, Clone)]
pub(super) struct LoadedSkillSummary {
    pub(super) headline: String,
    pub(super) details: Vec<String>,
}

pub(super) fn print_list_header() {
    println!("Discovering skills from standard locations...\n");
}

pub(super) fn print_empty_list() {
    println!("No skills found.");
    println!("\nCreate a traditional skill:");
    println!("  vtcode skills create ./my-skill");
    println!("\nOr install skills in standard locations:");
    println!("  .agents/skills/       (Repo skills, nearest directory first)");
    println!("  ~/.agents/skills/     (User skills)");
    println!("  /etc/codex/skills/    (Admin skills)");
}

pub(super) fn print_traditional_skills(rows: &[TraditionalSkillRow], warnings: &[String]) {
    if rows.is_empty() {
        return;
    }

    println!("Available Traditional Skills:");
    println!("{:-<70}", "");

    for row in rows {
        println!("{} {}\n  {}\n", row.status, row.name, row.description);
    }

    if warnings.is_empty() {
        return;
    }

    println!("\nCompatibility Notes:");
    for warning in warnings {
        println!("  {}", warning);
    }
    println!("\n  Use 'vtcode skills info <name>' for details and alternatives.");
}

pub(super) fn print_cli_tools(rows: &[CliToolRow]) {
    if rows.is_empty() {
        return;
    }

    println!("\nAvailable CLI Tool Skills:");
    println!("{:-<70}", "");

    for row in rows {
        println!(
            "⚡ {}\n  {}\n  Path: {}\n",
            row.name, row.description, row.path
        );
    }
}

pub(super) fn print_built_in_skills(rows: &[BuiltInSkillRow]) {
    if rows.is_empty() {
        return;
    }

    println!("\nAvailable Built-In Command Skills:");
    println!("{:-<70}", "");

    for row in rows {
        println!(
            "⌘ {}\n  {}\n  Usage: {}\n",
            row.name, row.description, row.usage
        );
    }
}

pub(super) fn print_list_usage() {
    println!("\nUsage:");
    println!("  Load skill:    vtcode skills load <name>");
    println!("  Skill info:    vtcode skills info <name>");
    println!("  Use in chat:   /skills load <name>");
    println!("  Or:            /skills use <name> <input>");
}

pub(super) fn print_loaded_skill(summary: &LoadedSkillSummary) {
    println!("{}", summary.headline);
    for detail in &summary.details {
        println!("  {}", detail);
    }
}

pub(super) fn print_skill_ready(name: &str) {
    println!(
        "\nSkill is ready to use. Use it in chat mode or with: vtcode ask 'Use {} for...'",
        name
    );
}

pub(super) fn print_skill_config(workspace: &Path) {
    println!("Skill Configuration\n");
    println!("Workspace: {}", workspace.display());
    println!("\nSkill Search Paths (by precedence):");
    println!("  • $CWD/.agents/skills/ ... repo-root/.agents/skills");
    println!("  • ~/.agents/skills/");
    println!("  • /etc/codex/skills/");
    println!("  • $CODEX_HOME/skills/.system/");

    println!("\nSkill Directory Structure:");
    println!("  my-skill/");
    println!("    ├── SKILL.md          (required: metadata + instructions)");
    println!("    ├── scripts/          (optional: executable scripts)");
    println!("    ├── references/       (optional: additional docs)");
    println!("    └── assets/           (optional: static resources)");

    println!("\nEnvironment Variables:");
    println!("  • HOME - Used to locate user skill directories");
    println!("  • CODEX_HOME - Used for bundled system skills cache");
}