octocode-cli 1.2.4 → 1.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -41,19 +41,27 @@ npx octocode-cli
41
41
  ## 📦 Installation & Usage
42
42
 
43
43
  ### Interactive Mode
44
+
44
45
  The recommended way to use Octocode CLI. Access all features through a unified menu:
45
- - **Octocode Configuration**: Setup MCP servers and GitHub auth.
46
- - **Manage System Skills**: Install AI capabilities.
47
- - **Manage System MCP**: Sync configs and browse the marketplace.
46
+
47
+ | Menu Item | Description |
48
+ |-----------|-------------|
49
+ | **🐙 Octocode MCP** | Install and configure Octocode MCP for your IDEs |
50
+ | **🐙 Octocode Skills** | Install AI-powered research, planning & review skills |
51
+ | **🧠 Manage System Skills** | Browse skills marketplace and manage installed skills |
52
+ | **🔑 Manage Auth** | Sign in/out via Octocode OAuth or gh CLI |
53
+ | **⚡ Manage System MCP** | Sync configs, browse MCP marketplace, inspect settings |
48
54
 
49
55
  ```bash
50
56
  npx octocode-cli
51
57
  ```
52
58
 
53
59
  ### CLI Commands
60
+
54
61
  For automation and power users, Octocode CLI offers a comprehensive command-line interface.
55
62
 
56
63
  #### 1. Install Octocode MCP
64
+
57
65
  Install the GitHub MCP server for your preferred IDE.
58
66
 
59
67
  ```bash
@@ -64,56 +72,82 @@ octocode-cli install
64
72
  octocode-cli install --ide cursor --method npx
65
73
  octocode-cli install --ide claude-desktop --method direct
66
74
  octocode-cli install --ide windsurf
75
+ octocode-cli install --ide zed
67
76
  ```
68
77
 
78
+ **Supported IDEs**: `cursor`, `claude-desktop`, `claude-code`, `windsurf`, `zed`, `vscode-cline`, `vscode-roo`, `vscode-continue`, `opencode`, `trae`, `antigravity`
79
+
69
80
  #### 2. Manage Authentication
81
+
70
82
  Securely authenticate with GitHub. Credentials are encrypted (AES-256-GCM) and stored in `~/.octocode/`.
71
83
 
72
84
  ```bash
73
- # Interactive login
85
+ # Interactive login (OAuth device flow)
74
86
  octocode-cli login
75
87
 
76
- # Check status
88
+ # Check authentication status
77
89
  octocode-cli status
78
90
 
79
91
  # Enterprise Login
80
92
  octocode-cli login --hostname github.mycompany.com
93
+
94
+ # Sign out
95
+ octocode-cli logout
96
+
97
+ # Auth management menu
98
+ octocode-cli auth
81
99
  ```
82
100
 
83
- #### 3. Sync Configurations
101
+ #### 3. Get GitHub Token
102
+
103
+ Retrieve tokens for scripting or debugging.
104
+
105
+ ```bash
106
+ # Get token (auto: env → gh → octocode)
107
+ octocode-cli token
108
+
109
+ # Get token from specific source
110
+ octocode-cli token --type=octocode
111
+ octocode-cli token --type=gh
112
+
113
+ # Show token source and user info
114
+ octocode-cli token --source
115
+
116
+ # JSON output for scripting
117
+ octocode-cli token --json
118
+ ```
119
+
120
+ #### 4. Sync Configurations
121
+
84
122
  Keep your MCP settings consistent across different editors.
85
123
 
86
124
  ```bash
87
125
  # Sync all IDEs
88
126
  octocode-cli sync
89
127
 
90
- # Preview changes
128
+ # Preview changes (dry run)
91
129
  octocode-cli sync --dry-run
130
+
131
+ # Show sync status
132
+ octocode-cli sync --status
133
+
134
+ # Force sync (auto-resolve conflicts)
135
+ octocode-cli sync --force
92
136
  ```
93
137
 
94
- #### 4. Manage Skills
138
+ #### 5. Manage Skills
139
+
95
140
  Install AI skills for Claude Code.
96
141
 
97
142
  ```bash
98
143
  # List available skills
99
144
  octocode-cli skills list
100
145
 
101
- # Install all standard skills
146
+ # Install all skills
102
147
  octocode-cli skills install
103
- ```
104
148
 
105
- #### 5. Additional Commands
106
- Other useful commands for power users.
107
-
108
- ```bash
109
- # Logout from GitHub
110
- octocode-cli logout
111
-
112
- # Get GitHub token (for scripting)
113
- octocode-cli token
114
-
115
- # Auth management menu
116
- octocode-cli auth
149
+ # Force reinstall (overwrite existing)
150
+ octocode-cli skills install --force
117
151
  ```
118
152
 
119
153
  ---