pmx 0.1.0

A CLI tool for managing AI agent profiles across different platforms (Claude, Codex)
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
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

use std::path::PathBuf;

use clap::{Args, Parser, Subcommand};

#[derive(Parser, Debug)]
#[command(name = "pmx")]
#[command(about = "A prompt management suite")]
#[command(version)]
pub struct Arg {
    /// Path to the storage directory
    #[arg(long)]
    pub config: Option<PathBuf>,
    #[command(subcommand)]
    pub command: Command,
}

#[derive(Debug, Subcommand)]
pub enum Command {
    /// Set Claude profile from a stored configuration
    SetClaudeProfile(ClaudeProfile),
    /// Reset the current Claude profile
    ResetClaudeProfile,
    /// Append Claude profile to existing configuration
    AppendClaudeProfile(ClaudeProfile),
    /// Set Codex profile from a stored configuration
    SetCodexProfile(CodexProfile),
    /// Reset the current Codex profile
    ResetCodexProfile,
    /// Append Codex profile to existing configuration
    AppendCodexProfile(CodexProfile),
    /// Profile management commands
    #[command(subcommand)]
    Profile(ProfileCommand),
    /// Generate shell completions
    Completion(CompletionArgs),
    /// Internal completion commands (hidden)
    #[command(subcommand, hide = true)]
    InternalCompletion(InternalCompletionCommand),
    /// Run MCP server to expose prompts
    Mcp(McpArgs),
}

#[derive(Debug, Args)]
pub struct ClaudeProfile {
    /// Path to the profile to apply
    pub path: String,
}

#[derive(Debug, Args)]
pub struct CodexProfile {
    /// Path to the profile to apply
    pub path: String,
}

#[derive(Debug, Args)]
pub struct CompletionArgs {
    /// Shell to generate completions for
    #[arg(value_enum)]
    pub shell: Shell,
}

#[derive(Debug, Clone, clap::ValueEnum)]
pub enum Shell {
    Zsh,
}

#[derive(Debug, Subcommand)]
pub enum ProfileCommand {
    /// List all available profiles
    List,
    /// Edit an existing profile using $EDITOR
    Edit(ProfileArgs),
    /// Delete a profile (with confirmation)
    Delete(ProfileArgs),
    /// Create a new profile using $EDITOR
    Create(ProfileArgs),
    /// Show profile content
    Show(ProfileArgs),
    /// Copy profile contents to clipboard
    Copy(ProfileArgs),
}

#[derive(Debug, Args)]
pub struct ProfileArgs {
    /// Name of the profile
    pub name: String,
}

#[derive(Debug, Args)]
pub struct McpArgs {
    // No arguments needed - MCP server reads from config.toml
}

#[derive(Debug, Subcommand)]
pub enum InternalCompletionCommand {
    /// List available Claude profiles (internal)
    ClaudeProfiles,
    /// List available Codex profiles (internal)
    CodexProfiles,
    /// List enabled agent commands (internal)
    EnabledCommands,
    /// List available profiles for profile commands (internal)
    ProfileNames,
}