@codemieai/code 0.0.7 → 0.0.9

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.
Files changed (188) hide show
  1. package/README.md +291 -47
  2. package/bin/agent-executor.js +6 -4
  3. package/dist/agents/codemie-code/agent.d.ts.map +1 -1
  4. package/dist/agents/codemie-code/agent.js +29 -28
  5. package/dist/agents/codemie-code/agent.js.map +1 -1
  6. package/dist/agents/codemie-code/config.d.ts.map +1 -1
  7. package/dist/agents/codemie-code/config.js +4 -3
  8. package/dist/agents/codemie-code/config.js.map +1 -1
  9. package/dist/agents/codemie-code/index.d.ts.map +1 -1
  10. package/dist/agents/codemie-code/index.js +10 -9
  11. package/dist/agents/codemie-code/index.js.map +1 -1
  12. package/dist/agents/codemie-code/tools/index.d.ts.map +1 -1
  13. package/dist/agents/codemie-code/tools/index.js +6 -5
  14. package/dist/agents/codemie-code/tools/index.js.map +1 -1
  15. package/dist/agents/codemie-code/ui/todoPanel.js +9 -9
  16. package/dist/agents/codemie-code/ui/todoPanel.js.map +1 -1
  17. package/dist/agents/codemie-code/ui.d.ts.map +1 -1
  18. package/dist/agents/codemie-code/ui.js +34 -33
  19. package/dist/agents/codemie-code/ui.js.map +1 -1
  20. package/dist/agents/core/AgentCLI.d.ts.map +1 -1
  21. package/dist/agents/core/AgentCLI.js +34 -17
  22. package/dist/agents/core/AgentCLI.js.map +1 -1
  23. package/dist/agents/core/BaseAgentAdapter.d.ts.map +1 -1
  24. package/dist/agents/core/BaseAgentAdapter.js +5 -11
  25. package/dist/agents/core/BaseAgentAdapter.js.map +1 -1
  26. package/dist/agents/plugins/claude.plugin.d.ts.map +1 -1
  27. package/dist/agents/plugins/claude.plugin.js +9 -0
  28. package/dist/agents/plugins/claude.plugin.js.map +1 -1
  29. package/dist/agents/plugins/codemie-code.plugin.d.ts +4 -0
  30. package/dist/agents/plugins/codemie-code.plugin.d.ts.map +1 -1
  31. package/dist/agents/plugins/codemie-code.plugin.js +9 -2
  32. package/dist/agents/plugins/codemie-code.plugin.js.map +1 -1
  33. package/dist/agents/plugins/deepagents.plugin.d.ts +21 -0
  34. package/dist/agents/plugins/deepagents.plugin.d.ts.map +1 -0
  35. package/dist/agents/plugins/deepagents.plugin.js +101 -0
  36. package/dist/agents/plugins/deepagents.plugin.js.map +1 -0
  37. package/dist/agents/registry.d.ts +1 -0
  38. package/dist/agents/registry.d.ts.map +1 -1
  39. package/dist/agents/registry.js +5 -2
  40. package/dist/agents/registry.js.map +1 -1
  41. package/dist/cli/commands/auth.js +5 -5
  42. package/dist/cli/commands/auth.js.map +1 -1
  43. package/dist/cli/commands/config.js +21 -21
  44. package/dist/cli/commands/config.js.map +1 -1
  45. package/dist/cli/commands/doctor/checks/AIConfigCheck.d.ts +13 -0
  46. package/dist/cli/commands/doctor/checks/AIConfigCheck.d.ts.map +1 -0
  47. package/dist/cli/commands/doctor/checks/AIConfigCheck.js +135 -0
  48. package/dist/cli/commands/doctor/checks/AIConfigCheck.js.map +1 -0
  49. package/dist/cli/commands/doctor/checks/AgentsCheck.d.ts +10 -0
  50. package/dist/cli/commands/doctor/checks/AgentsCheck.d.ts.map +1 -0
  51. package/dist/cli/commands/doctor/checks/AgentsCheck.js +57 -0
  52. package/dist/cli/commands/doctor/checks/AgentsCheck.js.map +1 -0
  53. package/dist/cli/commands/doctor/checks/NodeVersionCheck.d.ts +9 -0
  54. package/dist/cli/commands/doctor/checks/NodeVersionCheck.d.ts.map +1 -0
  55. package/dist/cli/commands/doctor/checks/NodeVersionCheck.js +38 -0
  56. package/dist/cli/commands/doctor/checks/NodeVersionCheck.js.map +1 -0
  57. package/dist/cli/commands/doctor/checks/NpmCheck.d.ts +9 -0
  58. package/dist/cli/commands/doctor/checks/NpmCheck.d.ts.map +1 -0
  59. package/dist/cli/commands/doctor/checks/NpmCheck.js +28 -0
  60. package/dist/cli/commands/doctor/checks/NpmCheck.js.map +1 -0
  61. package/dist/cli/commands/doctor/checks/WorkflowsCheck.d.ts +9 -0
  62. package/dist/cli/commands/doctor/checks/WorkflowsCheck.d.ts.map +1 -0
  63. package/dist/cli/commands/doctor/checks/WorkflowsCheck.js +72 -0
  64. package/dist/cli/commands/doctor/checks/WorkflowsCheck.js.map +1 -0
  65. package/dist/cli/commands/doctor/checks/index.d.ts +9 -0
  66. package/dist/cli/commands/doctor/checks/index.d.ts.map +1 -0
  67. package/dist/cli/commands/doctor/checks/index.js +9 -0
  68. package/dist/cli/commands/doctor/checks/index.js.map +1 -0
  69. package/dist/cli/commands/doctor/formatter.d.ts +53 -0
  70. package/dist/cli/commands/doctor/formatter.d.ts.map +1 -0
  71. package/dist/cli/commands/doctor/formatter.js +153 -0
  72. package/dist/cli/commands/doctor/formatter.js.map +1 -0
  73. package/dist/cli/commands/{doctor.d.ts → doctor/index.d.ts} +4 -1
  74. package/dist/cli/commands/doctor/index.d.ts.map +1 -0
  75. package/dist/cli/commands/doctor/index.js +67 -0
  76. package/dist/cli/commands/doctor/index.js.map +1 -0
  77. package/dist/cli/commands/doctor/providers/AIRunSSOProviderCheck.d.ts +11 -0
  78. package/dist/cli/commands/doctor/providers/AIRunSSOProviderCheck.d.ts.map +1 -0
  79. package/dist/cli/commands/doctor/providers/AIRunSSOProviderCheck.js +192 -0
  80. package/dist/cli/commands/doctor/providers/AIRunSSOProviderCheck.js.map +1 -0
  81. package/dist/cli/commands/doctor/providers/BaseProviderCheck.d.ts +12 -0
  82. package/dist/cli/commands/doctor/providers/BaseProviderCheck.d.ts.map +1 -0
  83. package/dist/cli/commands/doctor/providers/BaseProviderCheck.js +12 -0
  84. package/dist/cli/commands/doctor/providers/BaseProviderCheck.js.map +1 -0
  85. package/dist/cli/commands/doctor/providers/StandardProviderCheck.d.ts +11 -0
  86. package/dist/cli/commands/doctor/providers/StandardProviderCheck.d.ts.map +1 -0
  87. package/dist/cli/commands/doctor/providers/StandardProviderCheck.js +97 -0
  88. package/dist/cli/commands/doctor/providers/StandardProviderCheck.js.map +1 -0
  89. package/dist/cli/commands/doctor/providers/index.d.ts +30 -0
  90. package/dist/cli/commands/doctor/providers/index.d.ts.map +1 -0
  91. package/dist/cli/commands/doctor/providers/index.js +66 -0
  92. package/dist/cli/commands/doctor/providers/index.js.map +1 -0
  93. package/dist/cli/commands/doctor/types.d.ts +59 -0
  94. package/dist/cli/commands/doctor/types.d.ts.map +1 -0
  95. package/dist/cli/commands/doctor/types.js +5 -0
  96. package/dist/cli/commands/doctor/types.js.map +1 -0
  97. package/dist/cli/commands/install.d.ts.map +1 -1
  98. package/dist/cli/commands/install.js +24 -8
  99. package/dist/cli/commands/install.js.map +1 -1
  100. package/dist/cli/commands/list.js +3 -3
  101. package/dist/cli/commands/list.js.map +1 -1
  102. package/dist/cli/commands/profile.js +6 -6
  103. package/dist/cli/commands/profile.js.map +1 -1
  104. package/dist/cli/commands/setup.js +51 -38
  105. package/dist/cli/commands/setup.js.map +1 -1
  106. package/dist/cli/commands/uninstall.d.ts.map +1 -1
  107. package/dist/cli/commands/uninstall.js +19 -4
  108. package/dist/cli/commands/uninstall.js.map +1 -1
  109. package/dist/cli/commands/workflow.d.ts.map +1 -1
  110. package/dist/cli/commands/workflow.js +30 -59
  111. package/dist/cli/commands/workflow.js.map +1 -1
  112. package/dist/cli/index.js +1 -3
  113. package/dist/cli/index.js.map +1 -1
  114. package/dist/env/types.d.ts.map +1 -1
  115. package/dist/env/types.js +2 -2
  116. package/dist/env/types.js.map +1 -1
  117. package/dist/utils/async-tips.js +6 -6
  118. package/dist/utils/async-tips.js.map +1 -1
  119. package/dist/utils/codemie-integration-validator.d.ts +3 -2
  120. package/dist/utils/codemie-integration-validator.d.ts.map +1 -1
  121. package/dist/utils/codemie-integration-validator.js +38 -11
  122. package/dist/utils/codemie-integration-validator.js.map +1 -1
  123. package/dist/utils/config-loader.d.ts.map +1 -1
  124. package/dist/utils/config-loader.js +17 -6
  125. package/dist/utils/config-loader.js.map +1 -1
  126. package/dist/utils/credential-store.d.ts.map +1 -1
  127. package/dist/utils/credential-store.js +55 -24
  128. package/dist/utils/credential-store.js.map +1 -1
  129. package/dist/utils/first-time.d.ts +8 -0
  130. package/dist/utils/first-time.d.ts.map +1 -1
  131. package/dist/utils/first-time.js +133 -86
  132. package/dist/utils/first-time.js.map +1 -1
  133. package/dist/utils/logger.d.ts +19 -1
  134. package/dist/utils/logger.d.ts.map +1 -1
  135. package/dist/utils/logger.js +93 -8
  136. package/dist/utils/logger.js.map +1 -1
  137. package/dist/utils/sso-auth.d.ts.map +1 -1
  138. package/dist/utils/sso-auth.js +24 -10
  139. package/dist/utils/sso-auth.js.map +1 -1
  140. package/dist/utils/sso-gateway.d.ts +28 -0
  141. package/dist/utils/sso-gateway.d.ts.map +1 -1
  142. package/dist/utils/sso-gateway.js +201 -46
  143. package/dist/utils/sso-gateway.js.map +1 -1
  144. package/dist/utils/tips.js +3 -3
  145. package/dist/utils/tips.js.map +1 -1
  146. package/dist/workflows/installer.d.ts.map +1 -1
  147. package/dist/workflows/installer.js +3 -8
  148. package/dist/workflows/installer.js.map +1 -1
  149. package/package.json +9 -3
  150. package/dist/cli/commands/doctor.d.ts.map +0 -1
  151. package/dist/cli/commands/doctor.js +0 -365
  152. package/dist/cli/commands/doctor.js.map +0 -1
  153. package/dist/cli/commands/tools.d.ts +0 -6
  154. package/dist/cli/commands/tools.d.ts.map +0 -1
  155. package/dist/cli/commands/tools.js +0 -244
  156. package/dist/cli/commands/tools.js.map +0 -1
  157. package/dist/clients/adapters/github.d.ts +0 -17
  158. package/dist/clients/adapters/github.d.ts.map +0 -1
  159. package/dist/clients/adapters/github.js +0 -150
  160. package/dist/clients/adapters/github.js.map +0 -1
  161. package/dist/clients/adapters/gitlab.d.ts +0 -17
  162. package/dist/clients/adapters/gitlab.d.ts.map +0 -1
  163. package/dist/clients/adapters/gitlab.js +0 -147
  164. package/dist/clients/adapters/gitlab.js.map +0 -1
  165. package/dist/clients/registry.d.ts +0 -20
  166. package/dist/clients/registry.d.ts.map +0 -1
  167. package/dist/clients/registry.js +0 -27
  168. package/dist/clients/registry.js.map +0 -1
  169. package/dist/tools/detector.d.ts +0 -33
  170. package/dist/tools/detector.d.ts.map +0 -1
  171. package/dist/tools/detector.js +0 -145
  172. package/dist/tools/detector.js.map +0 -1
  173. package/dist/tools/index.d.ts +0 -8
  174. package/dist/tools/index.d.ts.map +0 -1
  175. package/dist/tools/index.js +0 -8
  176. package/dist/tools/index.js.map +0 -1
  177. package/dist/tools/manager.d.ts +0 -21
  178. package/dist/tools/manager.d.ts.map +0 -1
  179. package/dist/tools/manager.js +0 -104
  180. package/dist/tools/manager.js.map +0 -1
  181. package/dist/tools/registry.d.ts +0 -8
  182. package/dist/tools/registry.d.ts.map +0 -1
  183. package/dist/tools/registry.js +0 -36
  184. package/dist/tools/registry.js.map +0 -1
  185. package/dist/tools/types.d.ts +0 -41
  186. package/dist/tools/types.d.ts.map +0 -1
  187. package/dist/tools/types.js +0 -5
  188. package/dist/tools/types.js.map +0 -1
package/README.md CHANGED
@@ -37,6 +37,7 @@
37
37
  - [Claude Code](#claude-code)
38
38
  - [Codex](#codex)
39
39
  - [Gemini CLI](#gemini-cli)
40
+ - [Deep Agents CLI](#deep-agents-cli)
40
41
  - [Troubleshooting](#troubleshooting)
41
42
  - [Command Not Found](#command-not-found)
42
43
  - [Configuration Issues](#configuration-issues)
@@ -54,14 +55,21 @@
54
55
 
55
56
  ```bash
56
57
  codemie [COMMAND] [OPTIONS]
57
- codemie-code [MESSAGE|--task TASK] [OPTIONS]
58
+ codemie-code [MESSAGE] [OPTIONS]
58
59
  codemie-claude [-p MESSAGE] [OPTIONS]
59
- codemie-codex [MESSAGE|--task TASK] [OPTIONS]
60
+ codemie-codex [-p MESSAGE] [OPTIONS]
60
61
  codemie-gemini [-m MODEL] [-p MESSAGE] [OPTIONS]
61
62
  ```
62
63
 
63
64
  AI/Run CodeMie CLI is a professional, unified CLI tool for installing, configuring, and running multiple AI coding agents from a single interface. It includes a built-in LangGraph-based agent (CodeMie Native) and supports external agents like Claude Code, Codex, and Gemini CLI.
64
65
 
66
+ All agent shortcuts (`codemie-*`) share common configuration options:
67
+ - `--profile <name>` - Use specific provider profile
68
+ - `--model <model>` - Override model
69
+ - `--api-key <key>` - Override API key
70
+ - `--base-url <url>` - Override base URL
71
+ - `--debug` - Enable debug logging
72
+
65
73
  ## Quick Start
66
74
 
67
75
  ```bash
@@ -129,12 +137,12 @@ Ready to use immediately - no installation required:
129
137
  # Interactive conversation
130
138
  codemie-code
131
139
 
132
- # Execute single task
133
- codemie-code --task "fix bugs in src/utils"
134
-
135
140
  # Start with initial message
136
141
  codemie-code "Help me refactor this component"
137
142
 
143
+ # Execute single task (via main CLI)
144
+ codemie --task "fix bugs in src/utils"
145
+
138
146
  # Debug mode
139
147
  codemie-code --debug
140
148
  ```
@@ -147,13 +155,16 @@ Install and run external agents:
147
155
  # Install agents
148
156
  codemie install claude
149
157
  codemie install codex
158
+ codemie install gemini
150
159
 
151
- # Run via shortcuts (recommended)
152
- codemie-claude -p "Review my API code"
153
- codemie-codex --task "Generate unit tests"
160
+ # Run via direct shortcuts (recommended)
161
+ codemie-claude "Review my API code"
162
+ codemie-codex "Generate unit tests"
163
+ codemie-gemini "Optimize performance"
154
164
 
155
- # Direct shortcuts are the recommended way
156
- codemie-claude -p "Fix security issues"
165
+ # With model override
166
+ codemie-claude --model claude-4-5-sonnet "Fix security issues"
167
+ codemie-codex --model gpt-4.1 "Add type annotations"
157
168
  ```
158
169
 
159
170
  ## Commands
@@ -178,25 +189,32 @@ Direct access to agents with automatic configuration:
178
189
 
179
190
  ```bash
180
191
  # Built-in agent
181
- codemie-code [message] # Interactive or with initial message
182
- codemie-code --task "task" # Single task execution
192
+ codemie-code # Interactive mode
193
+ codemie-code "message" # Start with initial message
183
194
  codemie-code health # Health check
184
195
 
185
- # External agents
186
- codemie-claude # Claude Code agent (interactive)
187
- codemie-claude -p "message" # Claude Code agent (print mode)
188
- codemie-codex [message] # Codex agent
189
- codemie-gemini # Gemini CLI agent
196
+ # External agents (direct invocation)
197
+ codemie-claude "message" # Claude Code agent (interactive)
198
+ codemie-claude -p "message" # Claude Code agent (non-interactive/print mode)
199
+ codemie-codex "message" # Codex agent (interactive)
200
+ codemie-codex -p "message" # Codex agent (non-interactive mode)
201
+ codemie-gemini "message" # Gemini CLI agent
202
+ codemie-deepagents "message" # Deep Agents CLI agent
203
+
204
+ # With agent-specific options (pass-through to underlying CLI)
205
+ codemie-claude --context large -p "review code"
206
+ codemie-codex --temperature 0.1 -p "generate tests"
207
+ codemie-gemini -p "your prompt" # Gemini's non-interactive mode
190
208
 
191
209
  # Configuration overrides (model, API key, base URL, timeout)
192
- codemie-claude --model claude-4-5-sonnet --api-key your-key
193
- codemie-codex --model gpt-4.1 --base-url https://api.openai.com/v1
194
- codemie-gemini --model gemini-2.0-flash-exp
210
+ codemie-claude --model claude-4-5-sonnet --api-key your-key "review code"
211
+ codemie-codex --model gpt-4.1 --base-url https://api.openai.com/v1 "generate tests"
212
+ codemie-gemini -m gemini-2.5-flash "optimize performance"
195
213
 
196
214
  # Profile selection (profiles contain provider + all settings)
197
- codemie-code --profile work-litellm "task"
198
- codemie-claude --profile personal-openai -p "message"
199
- codemie-gemini --profile lite --model gemini-2.5-flash # Use LiteLLM proxy
215
+ codemie-code --profile work-litellm "analyze codebase"
216
+ codemie-claude --profile personal-openai "review PR"
217
+ codemie-gemini --profile lite --model gemini-2.5-flash "document code"
200
218
  ```
201
219
 
202
220
  ### Configuration Commands
@@ -364,7 +382,7 @@ Location: `~/.codemie/config.json`
364
382
  ```json
365
383
  {
366
384
  "provider": "litellm",
367
- "model": "claude-4-5-sonnet",
385
+ "model": "claude-sonnet-4-5",
368
386
  "baseUrl": "https://litellm.codemie.example.com",
369
387
  "apiKey": "your-api-key",
370
388
  "timeout": 300
@@ -426,7 +444,7 @@ codemie auth logout
426
444
 
427
445
  ### Token Management
428
446
 
429
- SSO tokens are automatically managed but you can control them manually:
447
+ SSO tokens are automatically managed, but you can control them manually:
430
448
 
431
449
  #### Token Refresh
432
450
 
@@ -497,16 +515,16 @@ AI/Run CodeMie SSO provides enterprise-grade features:
497
515
  codemie-code "Review this PR for security issues and performance"
498
516
 
499
517
  # Bug fixing
500
- codemie-claude -p "Fix the authentication bug in src/auth.ts"
518
+ codemie-claude "Fix the authentication bug in src/auth.ts"
501
519
 
502
520
  # Test generation
503
- codemie-codex --task "Generate comprehensive tests for the API endpoints"
521
+ codemie-codex "Generate comprehensive tests for the API endpoints"
504
522
 
505
523
  # Documentation
506
524
  codemie-code "Document the functions in utils/helpers.js"
507
525
 
508
526
  # Refactoring
509
- codemie-claude -p "Refactor this component to use React hooks"
527
+ codemie-claude "Refactor this component to use React hooks"
510
528
  ```
511
529
 
512
530
  ### Configuration Examples
@@ -522,10 +540,10 @@ codemie config test
522
540
  codemie config init
523
541
 
524
542
  # Temporary model override
525
- codemie-claude --model claude-4-5-sonnet -p "Explain this algorithm"
543
+ codemie-claude --model claude-4-5-sonnet "Explain this algorithm"
526
544
 
527
545
  # Debug mode for troubleshooting
528
- codemie-code --debug --task "analyze performance issues"
546
+ codemie-code --debug "analyze performance issues"
529
547
  ```
530
548
 
531
549
  ### Multi-Provider Workflow Examples
@@ -572,14 +590,53 @@ codemie setup
572
590
  ### Advanced Usage
573
591
 
574
592
  ```bash
575
- # Pass custom arguments to agents
593
+ # Pass custom arguments to agents (unknown options pass through)
576
594
  codemie-codex --temperature 0.1 --max-tokens 2000 "Generate clean code"
577
- codemie-claude -p "Review this code" --context large
595
+ codemie-claude --context large "Review this code"
596
+
597
+ # Non-interactive mode with -p (useful for CI/CD)
598
+ codemie-claude -p "$(cat prompt.txt)" --max-turns 50
599
+ codemie-codex -p "Generate tests for src/utils" --output json
600
+
601
+ # Debug logging (writes to ~/.codemie/debug/)
602
+ codemie-claude --debug "analyze codebase"
603
+ codemie-codex --debug "implement feature"
604
+ codemie-code --debug "test task"
605
+
606
+ # Debug logging (writes to ~/.codemie/debug/)
607
+ codemie-claude --debug "analyze codebase"
608
+ codemie-codex --debug "implement feature"
609
+ codemie-code --debug "test task"
578
610
 
579
611
  # Health checks
580
612
  codemie doctor # Full system check
581
613
  codemie-code health # Built-in agent check
582
614
  codemie-claude health # Claude agent check
615
+ codemie-gemini health # Gemini agent check
616
+ codemie-deepagents health # Deep Agents CLI check
617
+ ```
618
+
619
+ ### CI/CD Integration Example
620
+
621
+ ```bash
622
+ # GitHub Actions / GitLab CI workflow example
623
+ codemie-claude \
624
+ --base-url "${CODEMIE_BASE_URL}" \
625
+ --api-key "${CODEMIE_API_KEY}" \
626
+ --model "${CODEMIE_MODEL:-claude-4-5-sonnet}" \
627
+ --provider "litellm" \
628
+ -p "$(cat /tmp/review-prompt.txt)" \
629
+ --max-turns "${CODEMIE_MAX_TURNS:-50}" \
630
+ --dangerously-skip-permissions \
631
+ --allowedTools "Bash(*),Read(*),Curl(*)" \
632
+ --debug
633
+
634
+ # Using profile for CI/CD
635
+ codemie-claude \
636
+ --profile ci-litellm \
637
+ -p "Review this PR for security issues" \
638
+ --max-turns 30 \
639
+ --debug
583
640
  ```
584
641
 
585
642
  ## Agents
@@ -599,7 +656,8 @@ LangGraph-based coding assistant with no installation required.
599
656
  **Usage:**
600
657
  ```bash
601
658
  codemie-code # Interactive mode
602
- codemie-code --task "task" # Single task
659
+ codemie-code "task" # Start with message
660
+ codemie --task "task" # Single task execution
603
661
  codemie-code --debug # Debug mode
604
662
  ```
605
663
 
@@ -614,6 +672,15 @@ Anthropic's official CLI with advanced code understanding.
614
672
  - Multi-file editing capabilities
615
673
  - Project-aware context
616
674
  - Interactive conversations
675
+ - Non-interactive mode with `-p` flag
676
+
677
+ **Usage:**
678
+ ```bash
679
+ codemie-claude # Interactive mode
680
+ codemie-claude "message" # Start with message
681
+ codemie-claude -p "message" # Non-interactive/print mode
682
+ codemie-claude health # Health check
683
+ ```
617
684
 
618
685
  ### Codex
619
686
 
@@ -625,8 +692,17 @@ OpenAI's code generation assistant optimized for completion tasks.
625
692
  - Code completion and generation
626
693
  - Function generation and bug fixing
627
694
  - Code explanation and documentation
695
+ - Non-interactive mode with `-p` flag
628
696
  - **Requires OpenAI-compatible models only**
629
697
 
698
+ **Usage:**
699
+ ```bash
700
+ codemie-codex # Interactive mode
701
+ codemie-codex "message" # Start with message
702
+ codemie-codex -p "message" # Non-interactive mode
703
+ codemie-codex health # Health check
704
+ ```
705
+
630
706
  ### Gemini CLI
631
707
 
632
708
  Google's Gemini AI coding assistant with advanced code understanding.
@@ -658,8 +734,174 @@ export GEMINI_API_KEY="your-gemini-api-key-here"
658
734
  **Usage:**
659
735
  ```bash
660
736
  codemie-gemini # Interactive mode
661
- codemie-gemini -m gemini-2.5-flash # Specify model
662
- codemie-gemini -p "your prompt" # Non-interactive mode
737
+ codemie-gemini "your prompt" # With initial message
738
+ codemie-gemini -p "your prompt" # Non-interactive mode (Gemini-specific)
739
+ codemie-gemini -m gemini-2.5-flash # Specify model (Gemini-specific)
740
+ codemie-gemini --model gemini-2.5-flash "analyze code" # With config override
741
+ ```
742
+
743
+ ### Deep Agents CLI
744
+
745
+ LangChain's terminal interface for building agents with persistent memory. Built on LangGraph with planning capabilities, file system tools, and subagent delegation.
746
+
747
+ **Installation:** `codemie install deepagents`
748
+
749
+ **Links:**
750
+ - [Documentation](https://docs.langchain.com/oss/javascript/deepagents/cli)
751
+ - [Overview](https://docs.langchain.com/oss/javascript/deepagents/overview)
752
+ - [Middleware](https://docs.langchain.com/oss/javascript/deepagents/middleware)
753
+ - [Subagents](https://docs.langchain.com/oss/javascript/deepagents/subagents)
754
+ - [Customization](https://docs.langchain.com/oss/javascript/deepagents/customization)
755
+
756
+ **Usage:**
757
+ ```bash
758
+ codemie-deepagents # Interactive mode
759
+ codemie-deepagents "your task" # Start with message
760
+ codemie-deepagents --debug # Debug mode
761
+ codemie-deepagents health # Health check
762
+ ```
763
+
764
+ **Note:** Installed via Python (pip/uv), not npm. Requires Python 3.9+ and Anthropic or OpenAI API key.
765
+
766
+ ## Debug Logging
767
+
768
+ All CodeMie agents support comprehensive debug logging that writes to files.
769
+
770
+ ### Enabling Debug Mode
771
+
772
+ ```bash
773
+ # Using --debug flag (recommended)
774
+ codemie-claude --debug "your task"
775
+ codemie-codex --debug "your task"
776
+ codemie-code --debug "your task"
777
+
778
+ # Using environment variable
779
+ CODEMIE_DEBUG=1 codemie-claude "your task"
780
+
781
+ # For entire session
782
+ export CODEMIE_DEBUG=1
783
+ codemie-claude "task 1"
784
+ codemie-codex "task 2"
785
+ ```
786
+
787
+ ### Debug Log Files
788
+
789
+ When debug mode is enabled, each session creates a timestamped directory:
790
+
791
+ **Location:** `~/.codemie/debug/session-<timestamp>/`
792
+
793
+ **Log Files:**
794
+ 1. **application.log** - All application activity
795
+ - Contains: Info, warnings, errors, debug messages
796
+ - Format: Plain text with timestamps
797
+ - Example: `[2025-11-27T12:30:00.000Z] [INFO] Starting agent...`
798
+
799
+ 2. **requests.jsonl** - HTTP request/response details (ai-run-sso provider only)
800
+ - Contains: Request/response headers, bodies, timing
801
+ - Format: JSONL (one JSON object per line)
802
+ - Security: Sensitive headers automatically redacted
803
+ - Example: `{"type":"request","requestId":1,"method":"POST",...}`
804
+
805
+ ### Console Output
806
+
807
+ Debug mode keeps your console clean - you'll only see:
808
+ ```bash
809
+ $ codemie-claude --debug "analyze code"
810
+ Starting Claude Code | Profile: work | Provider: ai-run-sso | Model: claude-4-5-sonnet | Debug: /Users/username/.codemie/debug/session-2025-11-27T12-30-00-000Z
811
+ ```
812
+
813
+ All debug details are written to files in the session directory.
814
+
815
+ ### Analyzing Logs
816
+
817
+ **Using command-line tools:**
818
+ ```bash
819
+ # View latest application log
820
+ tail -f ~/.codemie/debug/session-*/application.log
821
+
822
+ # Search for errors in latest session
823
+ grep ERROR ~/.codemie/debug/session-*/application.log
824
+
825
+ # Parse HTTP requests with jq
826
+ cat ~/.codemie/debug/session-*/requests.jsonl | jq 'select(.type == "request")'
827
+ ```
828
+
829
+ **Clean up old logs:**
830
+ ```bash
831
+ # Remove session directories older than 7 days
832
+ find ~/.codemie/debug -type d -name "session-*" -mtime +7 -exec rm -rf {} +
833
+
834
+ # Remove all debug logs
835
+ rm -rf ~/.codemie/debug
836
+ ```
837
+
838
+ ## Debug Logging
839
+
840
+ All CodeMie agents support comprehensive debug logging that writes to files.
841
+
842
+ ### Enabling Debug Mode
843
+
844
+ ```bash
845
+ # Using --debug flag (recommended)
846
+ codemie-claude --debug "your task"
847
+ codemie-codex --debug "your task"
848
+ codemie-code --debug "your task"
849
+
850
+ # Using environment variable
851
+ CODEMIE_DEBUG=1 codemie-claude "your task"
852
+
853
+ # For entire session
854
+ export CODEMIE_DEBUG=1
855
+ codemie-claude "task 1"
856
+ codemie-codex "task 2"
857
+ ```
858
+
859
+ ### Debug Log Files
860
+
861
+ When debug mode is enabled, logs are written to a unified session directory:
862
+
863
+ **Location:** `~/.codemie/debug/session-<timestamp>/`
864
+
865
+ 1. **application.log** - All application logs
866
+ - Contains: Info, warnings, errors, debug messages
867
+ - Format: Plain text with timestamps
868
+
869
+ 2. **requests.jsonl** - HTTP request/response details (ai-run-sso provider only)
870
+ - Contains: Request/response headers, bodies, timing
871
+ - Format: JSONL (one JSON object per line)
872
+ - Security: Sensitive headers automatically redacted
873
+
874
+ ### Console Output
875
+
876
+ Debug mode keeps your console clean - you'll only see:
877
+ ```bash
878
+ $ codemie-claude --debug "analyze code"
879
+ Starting Claude Code | Profile: default | Provider: openai | Model: claude-sonnet-4-5 | Debug: /Users/username/.codemie/debug/session-2025-11-27T12-30-00-000Z
880
+ ```
881
+
882
+ All debug details are written to files in the session directory.
883
+
884
+ ### Analyzing Logs
885
+
886
+ **Using command-line tools:**
887
+ ```bash
888
+ # View latest application log
889
+ tail -f ~/.codemie/debug/session-*/application.log
890
+
891
+ # Search for errors in latest session
892
+ grep ERROR ~/.codemie/debug/session-*/application.log
893
+
894
+ # Parse HTTP request logs with jq (ai-run-sso only)
895
+ cat ~/.codemie/debug/session-*/requests.jsonl | jq 'select(.type == "request")'
896
+ ```
897
+
898
+ **Clean up old logs:**
899
+ ```bash
900
+ # Remove logs older than 7 days
901
+ find ~/.codemie/debug -name "session-*" -mtime +7 -delete
902
+
903
+ # Remove all debug logs
904
+ rm -rf ~/.codemie/debug
663
905
  ```
664
906
 
665
907
  ## Troubleshooting
@@ -733,19 +975,21 @@ When you see "Model not compatible" errors:
733
975
 
734
976
  ```
735
977
  codemie-code/
736
- ├── bin/ # Executable entry points
737
- │ ├── codemie.js # Main CLI
738
- ├── codemie-code.js # Built-in agent
739
- │ ├── codemie-claude.js # Claude shortcut
740
- │ └── codemie-codex.js # Codex shortcut
978
+ ├── bin/ # Executable entry points
979
+ │ ├── codemie.js # Main CLI
980
+ └── agent-executor.js # Universal agent executor (all shortcuts)
741
981
  ├── src/
742
- │ ├── agents/ # Agent registry and adapters
743
- │ ├── cli/ # CLI command implementations
744
- │ ├── env/ # Environment and config management
745
- ├── workflows/ # Workflow management
746
- │ ├── tools/ # VCS tools management
747
- │ └── utils/ # Shared utilities
748
- └── tests/ # Test files
982
+ │ ├── agents/ # Agent system
983
+ ├── core/ # Core agent abstractions
984
+ ├── plugins/ # Plugin-based adapters (claude, codex, gemini, codemie-code)
985
+ │ └── codemie-code/ # Built-in agent implementation
986
+ │ ├── cli/ # CLI commands
987
+ └── commands/ # Command implementations (setup, doctor, workflow, etc.)
988
+ │ ├── env/ # Configuration management
989
+ │ ├── workflows/ # CI/CD workflow management
990
+ │ │ └── templates/ # Workflow templates (GitHub Actions, GitLab CI)
991
+ │ └── utils/ # Shared utilities
992
+ └── tests/ # Test files
749
993
  ```
750
994
 
751
995
  ### Building
@@ -19,12 +19,14 @@ import { logger } from '../dist/utils/logger.js';
19
19
 
20
20
  // Detect agent from executable name
21
21
  // /usr/local/bin/codemie-claude → 'claude'
22
- // /usr/local/bin/codemie-code → 'codemie-code' (special case)
22
+ // /usr/local/bin/codemie-code → 'codemie-code' (special case for built-in agent)
23
+ // NOTE: 'codemie-code' constant defined in src/agents/plugins/codemie-code.plugin.ts
23
24
  const executableName = basename(process.argv[1]);
25
+ const BUILTIN_AGENT_NAME = 'codemie-code';
24
26
 
25
27
  let agentName;
26
- if (executableName === 'codemie-code') {
27
- agentName = 'codemie-code'; // Keep full name for built-in agent
28
+ if (executableName === BUILTIN_AGENT_NAME) {
29
+ agentName = BUILTIN_AGENT_NAME; // Keep full name for built-in agent
28
30
  } else {
29
31
  agentName = executableName.replace('codemie-', ''); // Strip prefix for external agents
30
32
  }
@@ -33,7 +35,7 @@ if (executableName === 'codemie-code') {
33
35
  const agent = AgentRegistry.getAgent(agentName);
34
36
 
35
37
  if (!agent) {
36
- logger.error(`Unknown agent: ${agentName}`);
38
+ logger.error(`Unknown agent '${agentName}'`);
37
39
  console.log('Available agents:', AgentRegistry.getAgentNames().join(', '));
38
40
  process.exit(1);
39
41
  }
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agents/codemie-code/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAA6B,MAAM,YAAY,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO/D,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAA2B;IACvD,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,KAAK,CAYX;gBAEU,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE;IAmB1D;;OAEG;IACH,OAAO,CAAC,SAAS;IA6LjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,cAAc,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuOvG;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4F1B;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BtD;;OAEG;IACH,YAAY,IAAI,IAAI;IA4BpB;;OAEG;IACH,UAAU,IAAI,WAAW,EAAE;IAI3B;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;OAEG;IACH,SAAS,IAAI,aAAa;IAQ1B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAsBF;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAclC"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agents/codemie-code/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAA6B,MAAM,YAAY,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAQ/D,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAA2B;IACvD,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,KAAK,CAYX;gBAEU,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE;IAmB1D;;OAEG;IACH,OAAO,CAAC,SAAS;IA6LjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,cAAc,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuOvG;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4F1B;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BtD;;OAEG;IACH,YAAY,IAAI,IAAI;IA4BpB;;OAEG;IACH,UAAU,IAAI,WAAW,EAAE;IAI3B;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;OAEG;IACH,SAAS,IAAI,aAAa;IAQ1B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAsBF;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAclC"}