@codemieai/code 0.0.3 → 0.0.4
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 +375 -325
- package/bin/codemie-claude.js +23 -0
- package/bin/codemie-code.js +49 -11
- package/bin/codemie-codex.js +12 -13
- package/dist/agents/adapters/claude-code.d.ts +5 -0
- package/dist/agents/adapters/claude-code.d.ts.map +1 -1
- package/dist/agents/adapters/claude-code.js +76 -18
- package/dist/agents/adapters/claude-code.js.map +1 -1
- package/dist/agents/adapters/codex.d.ts +5 -0
- package/dist/agents/adapters/codex.d.ts.map +1 -1
- package/dist/agents/adapters/codex.js +75 -17
- package/dist/agents/adapters/codex.js.map +1 -1
- package/dist/agents/codemie-code/agent.d.ts.map +1 -1
- package/dist/agents/codemie-code/agent.js +187 -21
- package/dist/agents/codemie-code/agent.js.map +1 -1
- package/dist/agents/codemie-code/config.d.ts.map +1 -1
- package/dist/agents/codemie-code/config.js +29 -27
- package/dist/agents/codemie-code/config.js.map +1 -1
- package/dist/agents/codemie-code/index.d.ts +16 -2
- package/dist/agents/codemie-code/index.d.ts.map +1 -1
- package/dist/agents/codemie-code/index.js +74 -6
- package/dist/agents/codemie-code/index.js.map +1 -1
- package/dist/agents/codemie-code/modes/contextAwarePlanning.d.ts +87 -0
- package/dist/agents/codemie-code/modes/contextAwarePlanning.d.ts.map +1 -0
- package/dist/agents/codemie-code/modes/contextAwarePlanning.js +957 -0
- package/dist/agents/codemie-code/modes/contextAwarePlanning.js.map +1 -0
- package/dist/agents/codemie-code/modes/planMode.d.ts +116 -0
- package/dist/agents/codemie-code/modes/planMode.d.ts.map +1 -0
- package/dist/agents/codemie-code/modes/planMode.js +537 -0
- package/dist/agents/codemie-code/modes/planMode.js.map +1 -0
- package/dist/agents/codemie-code/prompts.d.ts +29 -0
- package/dist/agents/codemie-code/prompts.d.ts.map +1 -1
- package/dist/agents/codemie-code/prompts.js +129 -0
- package/dist/agents/codemie-code/prompts.js.map +1 -1
- package/dist/agents/codemie-code/storage/todoStorage.d.ts +78 -0
- package/dist/agents/codemie-code/storage/todoStorage.d.ts.map +1 -0
- package/dist/agents/codemie-code/storage/todoStorage.js +225 -0
- package/dist/agents/codemie-code/storage/todoStorage.js.map +1 -0
- package/dist/agents/codemie-code/tokenUtils.js +1 -1
- package/dist/agents/codemie-code/tokenUtils.js.map +1 -1
- package/dist/agents/codemie-code/tools/index.d.ts +26 -0
- package/dist/agents/codemie-code/tools/index.d.ts.map +1 -1
- package/dist/agents/codemie-code/tools/index.js +182 -14
- package/dist/agents/codemie-code/tools/index.js.map +1 -1
- package/dist/agents/codemie-code/tools/planning.d.ts +53 -0
- package/dist/agents/codemie-code/tools/planning.d.ts.map +1 -0
- package/dist/agents/codemie-code/tools/planning.js +224 -0
- package/dist/agents/codemie-code/tools/planning.js.map +1 -0
- package/dist/agents/codemie-code/types.d.ts +170 -6
- package/dist/agents/codemie-code/types.d.ts.map +1 -1
- package/dist/agents/codemie-code/types.js.map +1 -1
- package/dist/agents/codemie-code/ui/progressTracker.d.ts +125 -0
- package/dist/agents/codemie-code/ui/progressTracker.d.ts.map +1 -0
- package/dist/agents/codemie-code/ui/progressTracker.js +343 -0
- package/dist/agents/codemie-code/ui/progressTracker.js.map +1 -0
- package/dist/agents/codemie-code/ui/todoPanel.d.ts +112 -0
- package/dist/agents/codemie-code/ui/todoPanel.d.ts.map +1 -0
- package/dist/agents/codemie-code/ui/todoPanel.js +318 -0
- package/dist/agents/codemie-code/ui/todoPanel.js.map +1 -0
- package/dist/agents/codemie-code/ui.d.ts +106 -10
- package/dist/agents/codemie-code/ui.d.ts.map +1 -1
- package/dist/agents/codemie-code/ui.js +913 -129
- package/dist/agents/codemie-code/ui.js.map +1 -1
- package/dist/agents/codemie-code/utils/progressionEnforcer.d.ts +87 -0
- package/dist/agents/codemie-code/utils/progressionEnforcer.d.ts.map +1 -0
- package/dist/agents/codemie-code/utils/progressionEnforcer.js +293 -0
- package/dist/agents/codemie-code/utils/progressionEnforcer.js.map +1 -0
- package/dist/agents/codemie-code/utils/todoParser.d.ts +41 -0
- package/dist/agents/codemie-code/utils/todoParser.d.ts.map +1 -0
- package/dist/agents/codemie-code/utils/todoParser.js +305 -0
- package/dist/agents/codemie-code/utils/todoParser.js.map +1 -0
- package/dist/agents/codemie-code/utils/todoValidator.d.ts +65 -0
- package/dist/agents/codemie-code/utils/todoValidator.d.ts.map +1 -0
- package/dist/agents/codemie-code/utils/todoValidator.js +249 -0
- package/dist/agents/codemie-code/utils/todoValidator.js.map +1 -0
- package/dist/agents/codemie-code/validators/planValidator.d.ts +94 -0
- package/dist/agents/codemie-code/validators/planValidator.d.ts.map +1 -0
- package/dist/agents/codemie-code/validators/planValidator.js +281 -0
- package/dist/agents/codemie-code/validators/planValidator.js.map +1 -0
- package/dist/agents/registry.d.ts.map +1 -1
- package/dist/agents/registry.js +7 -5
- package/dist/agents/registry.js.map +1 -1
- package/dist/cli/commands/auth.d.ts +3 -0
- package/dist/cli/commands/auth.d.ts.map +1 -0
- package/dist/cli/commands/auth.js +170 -0
- package/dist/cli/commands/auth.js.map +1 -0
- package/dist/cli/commands/config.d.ts.map +1 -1
- package/dist/cli/commands/config.js +40 -13
- package/dist/cli/commands/config.js.map +1 -1
- package/dist/cli/commands/doctor.d.ts.map +1 -1
- package/dist/cli/commands/doctor.js +209 -16
- package/dist/cli/commands/doctor.js.map +1 -1
- package/dist/cli/commands/env.js +3 -3
- package/dist/cli/commands/env.js.map +1 -1
- package/dist/cli/commands/install.d.ts.map +1 -1
- package/dist/cli/commands/install.js +2 -1
- package/dist/cli/commands/install.js.map +1 -1
- package/dist/cli/commands/run.d.ts.map +1 -1
- package/dist/cli/commands/run.js +15 -9
- package/dist/cli/commands/run.js.map +1 -1
- package/dist/cli/commands/setup.d.ts.map +1 -1
- package/dist/cli/commands/setup.js +177 -11
- package/dist/cli/commands/setup.js.map +1 -1
- package/dist/cli/commands/tools.d.ts +6 -0
- package/dist/cli/commands/tools.d.ts.map +1 -0
- package/dist/cli/commands/tools.js +244 -0
- package/dist/cli/commands/tools.js.map +1 -0
- package/dist/cli/commands/version.js +1 -1
- package/dist/cli/commands/version.js.map +1 -1
- package/dist/cli/commands/workflow.d.ts +6 -0
- package/dist/cli/commands/workflow.d.ts.map +1 -0
- package/dist/cli/commands/workflow.js +424 -0
- package/dist/cli/commands/workflow.js.map +1 -0
- package/dist/cli/index.js +39 -5
- package/dist/cli/index.js.map +1 -1
- package/dist/clients/adapters/github.d.ts +17 -0
- package/dist/clients/adapters/github.d.ts.map +1 -0
- package/dist/clients/adapters/github.js +150 -0
- package/dist/clients/adapters/github.js.map +1 -0
- package/dist/clients/adapters/gitlab.d.ts +17 -0
- package/dist/clients/adapters/gitlab.d.ts.map +1 -0
- package/dist/clients/adapters/gitlab.js +147 -0
- package/dist/clients/adapters/gitlab.js.map +1 -0
- package/dist/clients/registry.d.ts +20 -0
- package/dist/clients/registry.d.ts.map +1 -0
- package/dist/clients/registry.js +27 -0
- package/dist/clients/registry.js.map +1 -0
- package/dist/tools/detector.d.ts +33 -0
- package/dist/tools/detector.d.ts.map +1 -0
- package/dist/tools/detector.js +145 -0
- package/dist/tools/detector.js.map +1 -0
- package/dist/tools/index.d.ts +8 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +8 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/manager.d.ts +21 -0
- package/dist/tools/manager.d.ts.map +1 -0
- package/dist/tools/manager.js +104 -0
- package/dist/tools/manager.js.map +1 -0
- package/dist/tools/registry.d.ts +8 -0
- package/dist/tools/registry.d.ts.map +1 -0
- package/dist/tools/registry.js +36 -0
- package/dist/tools/registry.js.map +1 -0
- package/dist/tools/types.d.ts +41 -0
- package/dist/tools/types.d.ts.map +1 -0
- package/dist/tools/types.js +5 -0
- package/dist/tools/types.js.map +1 -0
- package/dist/types/sso.d.ts +42 -0
- package/dist/types/sso.d.ts.map +1 -0
- package/dist/types/sso.js +2 -0
- package/dist/types/sso.js.map +1 -0
- package/dist/utils/agent-compatibility.d.ts +32 -0
- package/dist/utils/agent-compatibility.d.ts.map +1 -0
- package/dist/utils/agent-compatibility.js +140 -0
- package/dist/utils/agent-compatibility.js.map +1 -0
- package/dist/utils/codemie-integration-validator.d.ts +17 -0
- package/dist/utils/codemie-integration-validator.d.ts.map +1 -0
- package/dist/utils/codemie-integration-validator.js +105 -0
- package/dist/utils/codemie-integration-validator.js.map +1 -0
- package/dist/utils/codemie-model-fetcher.d.ts +11 -0
- package/dist/utils/codemie-model-fetcher.d.ts.map +1 -0
- package/dist/utils/codemie-model-fetcher.js +242 -0
- package/dist/utils/codemie-model-fetcher.js.map +1 -0
- package/dist/utils/config-loader.d.ts +23 -1
- package/dist/utils/config-loader.d.ts.map +1 -1
- package/dist/utils/config-loader.js +73 -27
- package/dist/utils/config-loader.js.map +1 -1
- package/dist/utils/credential-store.d.ts +16 -0
- package/dist/utils/credential-store.d.ts.map +1 -0
- package/dist/utils/credential-store.js +109 -0
- package/dist/utils/credential-store.js.map +1 -0
- package/dist/utils/first-time.d.ts +1 -1
- package/dist/utils/first-time.d.ts.map +1 -1
- package/dist/utils/first-time.js +52 -71
- package/dist/utils/first-time.js.map +1 -1
- package/dist/utils/health-checker.d.ts.map +1 -1
- package/dist/utils/health-checker.js +5 -1
- package/dist/utils/health-checker.js.map +1 -1
- package/dist/utils/model-fetcher.d.ts.map +1 -1
- package/dist/utils/model-fetcher.js +15 -2
- package/dist/utils/model-fetcher.js.map +1 -1
- package/dist/utils/sso-auth.d.ts +15 -0
- package/dist/utils/sso-auth.d.ts.map +1 -0
- package/dist/utils/sso-auth.js +207 -0
- package/dist/utils/sso-auth.js.map +1 -0
- package/dist/utils/sso-gateway.d.ts +47 -0
- package/dist/utils/sso-gateway.d.ts.map +1 -0
- package/dist/utils/sso-gateway.js +298 -0
- package/dist/utils/sso-gateway.js.map +1 -0
- package/dist/workflows/detector.d.ts +37 -0
- package/dist/workflows/detector.d.ts.map +1 -0
- package/dist/workflows/detector.js +160 -0
- package/dist/workflows/detector.js.map +1 -0
- package/dist/workflows/index.d.ts +8 -0
- package/dist/workflows/index.d.ts.map +1 -0
- package/dist/workflows/index.js +8 -0
- package/dist/workflows/index.js.map +1 -0
- package/dist/workflows/installer.d.ts +24 -0
- package/dist/workflows/installer.d.ts.map +1 -0
- package/dist/workflows/installer.js +105 -0
- package/dist/workflows/installer.js.map +1 -0
- package/dist/workflows/registry.d.ts +29 -0
- package/dist/workflows/registry.d.ts.map +1 -0
- package/dist/workflows/registry.js +54 -0
- package/dist/workflows/registry.js.map +1 -0
- package/dist/workflows/templates/github/metadata.d.ts +6 -0
- package/dist/workflows/templates/github/metadata.d.ts.map +1 -0
- package/dist/workflows/templates/github/metadata.js +111 -0
- package/dist/workflows/templates/github/metadata.js.map +1 -0
- package/dist/workflows/templates/gitlab/metadata.d.ts +6 -0
- package/dist/workflows/templates/gitlab/metadata.d.ts.map +1 -0
- package/dist/workflows/templates/gitlab/metadata.js +14 -0
- package/dist/workflows/templates/gitlab/metadata.js.map +1 -0
- package/dist/workflows/types.d.ts +71 -0
- package/dist/workflows/types.d.ts.map +1 -0
- package/dist/workflows/types.js +5 -0
- package/dist/workflows/types.js.map +1 -0
- package/package.json +19 -6
- package/src/workflows/templates/github/code-ci.yml +529 -0
- package/src/workflows/templates/github/inline-fix.yml +665 -0
- package/src/workflows/templates/github/pr-review.yml +677 -0
- package/.claude/agents/README.md +0 -298
- package/.claude/agents/release-manager.md +0 -857
- package/.codemie/guides/git-workflow.md +0 -493
- package/CLAUDE.md +0 -225
- package/config.example.json +0 -10
- package/dist/agents/codemie-code/streaming/events.d.ts +0 -7
- package/dist/agents/codemie-code/streaming/events.d.ts.map +0 -1
- package/dist/agents/codemie-code/streaming/events.js +0 -7
- package/dist/agents/codemie-code/streaming/events.js.map +0 -1
- package/dist/agents/codemie-code/streaming/formatter.d.ts +0 -2
- package/dist/agents/codemie-code/streaming/formatter.d.ts.map +0 -1
- package/dist/agents/codemie-code/streaming/formatter.js +0 -2
- package/dist/agents/codemie-code/streaming/formatter.js.map +0 -1
- package/dist/agents/codemie-code/streaming/ui.d.ts +0 -2
- package/dist/agents/codemie-code/streaming/ui.d.ts.map +0 -1
- package/dist/agents/codemie-code/streaming/ui.js +0 -2
- package/dist/agents/codemie-code/streaming/ui.js.map +0 -1
- package/dist/agents/codemie-code/tools/command.d.ts +0 -2
- package/dist/agents/codemie-code/tools/command.d.ts.map +0 -1
- package/dist/agents/codemie-code/tools/command.js +0 -2
- package/dist/agents/codemie-code/tools/command.js.map +0 -1
- package/dist/agents/codemie-code/tools/filesystem.d.ts +0 -2
- package/dist/agents/codemie-code/tools/filesystem.d.ts.map +0 -1
- package/dist/agents/codemie-code/tools/filesystem.js +0 -2
- package/dist/agents/codemie-code/tools/filesystem.js.map +0 -1
- package/dist/agents/codemie-code/tools/git.d.ts +0 -2
- package/dist/agents/codemie-code/tools/git.d.ts.map +0 -1
- package/dist/agents/codemie-code/tools/git.js +0 -2
- package/dist/agents/codemie-code/tools/git.js.map +0 -1
- package/dist/agents/codemie-code/tools/security.d.ts +0 -2
- package/dist/agents/codemie-code/tools/security.d.ts.map +0 -1
- package/dist/agents/codemie-code/tools/security.js +0 -2
- package/dist/agents/codemie-code/tools/security.js.map +0 -1
- package/eslint.config.mjs +0 -43
- package/scripts/README.md +0 -80
- package/scripts/release.sh +0 -156
package/README.md
CHANGED
|
@@ -1,25 +1,79 @@
|
|
|
1
|
-
# CodeMie
|
|
1
|
+
# AI/Run CodeMie CLI
|
|
2
|
+
|
|
3
|
+
> Professional CLI wrapper for managing multiple AI coding agents
|
|
4
|
+
|
|
5
|
+
## Table of Contents
|
|
6
|
+
|
|
7
|
+
- [Synopsis](#synopsis)
|
|
8
|
+
- [Quick Start](#quick-start)
|
|
9
|
+
- [Installation](#installation)
|
|
10
|
+
- [From npm (Recommended)](#from-npm-recommended)
|
|
11
|
+
- [From Source (Development)](#from-source-development)
|
|
12
|
+
- [Verify Installation](#verify-installation)
|
|
13
|
+
- [Usage](#usage)
|
|
14
|
+
- [Built-in Agent (CodeMie Native)](#built-in-agent-codemie-native)
|
|
15
|
+
- [External Agents](#external-agents)
|
|
16
|
+
- [Commands](#commands)
|
|
17
|
+
- [Core Commands](#core-commands)
|
|
18
|
+
- [Agent Shortcuts](#agent-shortcuts)
|
|
19
|
+
- [Configuration Commands](#configuration-commands)
|
|
20
|
+
- [Configuration](#configuration)
|
|
21
|
+
- [Setup Wizard (Recommended)](#setup-wizard-recommended)
|
|
22
|
+
- [Supported Providers](#supported-providers)
|
|
23
|
+
- [Manual Configuration](#manual-configuration)
|
|
24
|
+
- [Model Compatibility](#model-compatibility)
|
|
25
|
+
- [Authentication & SSO Management](#authentication--sso-management)
|
|
26
|
+
- [AI/Run CodeMie SSO Setup](#airun-codemie-sso-setup)
|
|
27
|
+
- [Token Management](#token-management)
|
|
28
|
+
- [Enterprise SSO Features](#enterprise-sso-features)
|
|
29
|
+
- [Examples](#examples)
|
|
30
|
+
- [Common Workflows](#common-workflows)
|
|
31
|
+
- [Configuration Examples](#configuration-examples)
|
|
32
|
+
- [Advanced Usage](#advanced-usage)
|
|
33
|
+
- [Agents](#agents)
|
|
34
|
+
- [CodeMie Native (Built-in)](#codemie-native-built-in)
|
|
35
|
+
- [Claude Code](#claude-code)
|
|
36
|
+
- [Codex](#codex)
|
|
37
|
+
- [Troubleshooting](#troubleshooting)
|
|
38
|
+
- [Command Not Found](#command-not-found)
|
|
39
|
+
- [Configuration Issues](#configuration-issues)
|
|
40
|
+
- [Connection Problems](#connection-problems)
|
|
41
|
+
- [Agent Installation Failures](#agent-installation-failures)
|
|
42
|
+
- [Model Compatibility Errors](#model-compatibility-errors)
|
|
43
|
+
- [Development](#development)
|
|
44
|
+
- [Project Structure](#project-structure)
|
|
45
|
+
- [Building](#building)
|
|
46
|
+
- [Testing](#testing)
|
|
47
|
+
- [License](#license)
|
|
48
|
+
- [Links](#links)
|
|
49
|
+
|
|
50
|
+
## Synopsis
|
|
2
51
|
|
|
3
|
-
|
|
52
|
+
```bash
|
|
53
|
+
codemie [COMMAND] [OPTIONS]
|
|
54
|
+
codemie-code [MESSAGE|--task TASK] [OPTIONS]
|
|
55
|
+
codemie-claude [-p MESSAGE] [OPTIONS]
|
|
56
|
+
codemie-codex [MESSAGE|--task TASK] [OPTIONS]
|
|
57
|
+
```
|
|
4
58
|
|
|
5
|
-
CodeMie is a unified CLI tool for installing, configuring, and running multiple AI coding agents
|
|
59
|
+
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 and Codex.
|
|
6
60
|
|
|
7
|
-
##
|
|
61
|
+
## Quick Start
|
|
8
62
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
- 🛠️ **Environment Management** - Centralized configuration for all agents
|
|
13
|
-
- 🚀 **Zero Hassle** - Install and run agents with simple commands
|
|
14
|
-
- 📦 **Provider Agnostic** - Works with any AI provider (OpenAI, Anthropic, Azure, etc.)
|
|
15
|
-
- 🎯 **Task Execution** - Single task mode with `--task` flag for automation
|
|
16
|
-
- 🖼️ **Clipboard Integration** - Automatic image detection from system clipboard
|
|
63
|
+
```bash
|
|
64
|
+
# 1. Install
|
|
65
|
+
npm install -g @codemieai/code
|
|
17
66
|
|
|
18
|
-
|
|
67
|
+
# 2. Setup (interactive wizard)
|
|
68
|
+
codemie setup
|
|
19
69
|
|
|
20
|
-
|
|
70
|
+
# 3. Start coding with built-in agent
|
|
71
|
+
codemie-code "Review my code for bugs"
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Installation
|
|
21
75
|
|
|
22
|
-
### From npm (
|
|
76
|
+
### From npm (Recommended)
|
|
23
77
|
|
|
24
78
|
```bash
|
|
25
79
|
npm install -g @codemieai/code
|
|
@@ -28,478 +82,474 @@ npm install -g @codemieai/code
|
|
|
28
82
|
### From Source (Development)
|
|
29
83
|
|
|
30
84
|
```bash
|
|
31
|
-
# Clone the repository
|
|
32
85
|
git clone https://github.com/codemie-ai/codemie-code.git
|
|
33
86
|
cd codemie-code
|
|
34
|
-
|
|
35
|
-
# Install dependencies
|
|
36
|
-
npm install
|
|
37
|
-
|
|
38
|
-
# Build the project
|
|
39
|
-
npm run build
|
|
40
|
-
|
|
41
|
-
# Link globally for testing
|
|
42
|
-
npm link
|
|
87
|
+
npm install && npm run build && npm link
|
|
43
88
|
```
|
|
44
89
|
|
|
45
90
|
### Verify Installation
|
|
46
91
|
|
|
47
92
|
```bash
|
|
48
|
-
# Check if command is available
|
|
49
93
|
codemie --help
|
|
50
|
-
|
|
51
|
-
# Run health check
|
|
52
94
|
codemie doctor
|
|
53
95
|
```
|
|
54
96
|
|
|
55
|
-
|
|
97
|
+
## Usage
|
|
56
98
|
|
|
57
|
-
|
|
99
|
+
### Built-in Agent (CodeMie Native)
|
|
58
100
|
|
|
59
|
-
|
|
101
|
+
Ready to use immediately - no installation required:
|
|
60
102
|
|
|
61
|
-
|
|
103
|
+
```bash
|
|
104
|
+
# Interactive conversation
|
|
105
|
+
codemie-code
|
|
62
106
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
```
|
|
107
|
+
# Execute single task
|
|
108
|
+
codemie-code --task "fix bugs in src/utils"
|
|
66
109
|
|
|
67
|
-
|
|
110
|
+
# Start with initial message
|
|
111
|
+
codemie-code "Help me refactor this component"
|
|
68
112
|
|
|
69
|
-
|
|
70
|
-
|
|
113
|
+
# Debug mode
|
|
114
|
+
codemie-code --debug
|
|
71
115
|
```
|
|
72
116
|
|
|
73
|
-
###
|
|
74
|
-
|
|
75
|
-
#### Method A: Interactive Setup Wizard (Recommended)
|
|
117
|
+
### External Agents
|
|
76
118
|
|
|
77
|
-
|
|
119
|
+
Install and run external agents:
|
|
78
120
|
|
|
79
121
|
```bash
|
|
80
|
-
|
|
81
|
-
|
|
122
|
+
# Install agents
|
|
123
|
+
codemie install claude
|
|
124
|
+
codemie install codex
|
|
82
125
|
|
|
83
|
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
86
|
-
- ✅ **Validates credentials** via `/health` endpoint
|
|
87
|
-
- ✅ **Fetches available models** via `/v1/models` endpoint
|
|
88
|
-
- ✅ Shows real-time model list (no hardcoded options)
|
|
89
|
-
- ✅ Saves to `~/.codemie/config.json`
|
|
126
|
+
# Run via shortcuts (recommended)
|
|
127
|
+
codemie-claude -p "Review my API code"
|
|
128
|
+
codemie-codex --task "Generate unit tests"
|
|
90
129
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
- Anthropic (Direct API)
|
|
95
|
-
- Azure OpenAI (for GPT models and Codex)
|
|
96
|
-
- Custom LiteLLM Proxy
|
|
130
|
+
# Or run through main CLI
|
|
131
|
+
codemie run claude --task "Fix security issues"
|
|
132
|
+
```
|
|
97
133
|
|
|
98
|
-
|
|
134
|
+
## Commands
|
|
99
135
|
|
|
100
|
-
|
|
136
|
+
### Core Commands
|
|
101
137
|
|
|
102
138
|
```bash
|
|
103
|
-
|
|
104
|
-
codemie
|
|
139
|
+
codemie setup # Interactive configuration wizard
|
|
140
|
+
codemie auth <command> # Manage SSO authentication
|
|
141
|
+
codemie list # List all available agents
|
|
142
|
+
codemie install <agent> # Install an agent
|
|
143
|
+
codemie uninstall <agent> # Uninstall an agent
|
|
144
|
+
codemie run <agent> [args...] # Run an agent
|
|
145
|
+
codemie doctor # Health check and diagnostics
|
|
146
|
+
codemie config <action> # Manage configuration
|
|
147
|
+
codemie version # Show version information
|
|
105
148
|
```
|
|
106
149
|
|
|
107
|
-
###
|
|
150
|
+
### Agent Shortcuts
|
|
108
151
|
|
|
109
|
-
|
|
152
|
+
Direct access to agents with automatic configuration:
|
|
153
|
+
|
|
154
|
+
```bash
|
|
155
|
+
# Built-in agent
|
|
156
|
+
codemie-code [message] # Interactive or with initial message
|
|
157
|
+
codemie-code --task "task" # Single task execution
|
|
158
|
+
codemie-code health # Health check
|
|
159
|
+
|
|
160
|
+
# External agents
|
|
161
|
+
codemie-claude # Claude Code agent (interactive)
|
|
162
|
+
codemie-claude -p "message" # Claude Code agent (print mode)
|
|
163
|
+
codemie-codex [message] # Codex agent
|
|
164
|
+
|
|
165
|
+
# Configuration overrides
|
|
166
|
+
codemie-claude --model claude-4-5-sonnet --api-key your-key
|
|
167
|
+
codemie-codex --model gpt-4o --provider openai
|
|
168
|
+
```
|
|
110
169
|
|
|
111
|
-
|
|
170
|
+
### Configuration Commands
|
|
112
171
|
|
|
113
172
|
```bash
|
|
114
|
-
#
|
|
115
|
-
codemie
|
|
173
|
+
codemie config list # Show all configuration
|
|
174
|
+
codemie config get <key> # Get specific value
|
|
175
|
+
codemie config set <key> <value> # Set configuration value
|
|
176
|
+
codemie config reset # Reset to defaults
|
|
177
|
+
```
|
|
116
178
|
|
|
117
|
-
|
|
118
|
-
codemie-code
|
|
179
|
+
## Configuration
|
|
119
180
|
|
|
120
|
-
|
|
121
|
-
codemie-code --task "Help me debug this error"
|
|
181
|
+
### Setup Wizard (Recommended)
|
|
122
182
|
|
|
123
|
-
|
|
124
|
-
|
|
183
|
+
Run the interactive setup wizard:
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
codemie setup
|
|
125
187
|
```
|
|
126
188
|
|
|
127
|
-
|
|
189
|
+
The wizard will:
|
|
190
|
+
- Guide you through provider selection
|
|
191
|
+
- Test your credentials via health endpoints
|
|
192
|
+
- Fetch available models in real-time
|
|
193
|
+
- Save configuration to `~/.codemie/config.json`
|
|
128
194
|
|
|
129
|
-
|
|
130
|
-
# Install Claude Code
|
|
131
|
-
codemie install claude
|
|
195
|
+
### Supported Providers
|
|
132
196
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
197
|
+
- **ai-run-sso** - AI/Run CodeMie SSO (unified enterprise gateway)
|
|
198
|
+
- **openai** - OpenAI API
|
|
199
|
+
- **azure** - Azure OpenAI
|
|
200
|
+
- **bedrock** - AWS Bedrock
|
|
201
|
+
- **litellm** - LiteLLM Proxy
|
|
202
|
+
|
|
203
|
+
### Manual Configuration
|
|
136
204
|
|
|
137
|
-
####
|
|
205
|
+
#### Environment Variables (Highest Priority)
|
|
138
206
|
|
|
139
207
|
```bash
|
|
140
|
-
|
|
208
|
+
# Generic (works with any provider)
|
|
209
|
+
export CODEMIE_BASE_URL="https://your-proxy.com"
|
|
210
|
+
export CODEMIE_API_KEY="your-api-key"
|
|
211
|
+
export CODEMIE_MODEL="your-model"
|
|
212
|
+
export CODEMIE_PROVIDER="litellm"
|
|
213
|
+
|
|
214
|
+
# Provider-specific
|
|
215
|
+
export OPENAI_API_KEY="your-openai-key"
|
|
216
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1"
|
|
141
217
|
```
|
|
142
218
|
|
|
143
|
-
####
|
|
219
|
+
#### Configuration File
|
|
144
220
|
|
|
145
|
-
|
|
221
|
+
Location: `~/.codemie/config.json`
|
|
146
222
|
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
|
|
223
|
+
```json
|
|
224
|
+
{
|
|
225
|
+
"provider": "litellm",
|
|
226
|
+
"model": "claude-4-5-sonnet",
|
|
227
|
+
"baseUrl": "https://litellm.codemie.example.com",
|
|
228
|
+
"apiKey": "your-api-key",
|
|
229
|
+
"timeout": 300
|
|
230
|
+
}
|
|
231
|
+
```
|
|
150
232
|
|
|
151
|
-
|
|
152
|
-
codemie run claude
|
|
233
|
+
### Model Compatibility
|
|
153
234
|
|
|
154
|
-
|
|
155
|
-
codemie run codex
|
|
156
|
-
```
|
|
235
|
+
AI/Run CodeMie CLI automatically validates model compatibility:
|
|
157
236
|
|
|
158
|
-
**
|
|
237
|
+
- **Codex**: OpenAI models only (gpt-4, gpt-4o, gpt-5, etc.)
|
|
238
|
+
- **Claude**: Both Claude and GPT models
|
|
239
|
+
- **CodeMie Native**: All supported models
|
|
159
240
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
241
|
+
When incompatible models are detected, AI/Run CodeMie CLI will:
|
|
242
|
+
1. Fetch available models from your provider's API
|
|
243
|
+
2. Filter to compatible models
|
|
244
|
+
3. Offer to switch automatically
|
|
163
245
|
|
|
164
|
-
|
|
165
|
-
1. Detect the incompatibility
|
|
166
|
-
2. **Fetch available models** from your provider's `/v1/models` API endpoint
|
|
167
|
-
3. Filter to show only compatible models
|
|
168
|
-
4. Offer to switch to a compatible GPT model
|
|
169
|
-
5. Optionally save your choice
|
|
246
|
+
## Authentication & SSO Management
|
|
170
247
|
|
|
171
|
-
|
|
172
|
-
- Models are fetched in real-time from your configured provider
|
|
173
|
-
- No hardcoded lists - always shows what's actually available
|
|
174
|
-
- Results are cached for 5 minutes to improve performance
|
|
175
|
-
- Works with any OpenAI-compatible API (AI/Run, LiteLLM, OpenAI, etc.)
|
|
248
|
+
### AI/Run CodeMie SSO Setup
|
|
176
249
|
|
|
177
|
-
|
|
250
|
+
For enterprise environments with AI/Run CodeMie SSO (Single Sign-On):
|
|
178
251
|
|
|
179
|
-
|
|
252
|
+
#### Initial Setup via Wizard
|
|
180
253
|
|
|
181
|
-
|
|
254
|
+
The setup wizard automatically detects and configures AI/Run CodeMie SSO:
|
|
182
255
|
|
|
183
256
|
```bash
|
|
184
|
-
# Setup wizard (interactive configuration)
|
|
185
257
|
codemie setup
|
|
258
|
+
```
|
|
186
259
|
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
260
|
+
**The wizard will:**
|
|
261
|
+
1. Detect if you have access to AI/Run CodeMie SSO
|
|
262
|
+
2. Guide you through the authentication flow
|
|
263
|
+
3. Test the connection with health checks
|
|
264
|
+
4. Fetch and display available models
|
|
265
|
+
5. Save secure credentials to `~/.codemie/config.json`
|
|
192
266
|
|
|
193
|
-
|
|
194
|
-
codemie install <agent>
|
|
267
|
+
#### Manual SSO Authentication
|
|
195
268
|
|
|
196
|
-
|
|
197
|
-
codemie uninstall <agent>
|
|
269
|
+
If you need to authenticate separately or refresh your credentials:
|
|
198
270
|
|
|
199
|
-
|
|
200
|
-
|
|
271
|
+
```bash
|
|
272
|
+
# Authenticate with AI/Run CodeMie SSO
|
|
273
|
+
codemie auth login --url https://your-airun-codemie-instance.com
|
|
201
274
|
|
|
202
|
-
# Check
|
|
203
|
-
codemie
|
|
275
|
+
# Check authentication status
|
|
276
|
+
codemie auth status
|
|
204
277
|
|
|
205
|
-
#
|
|
206
|
-
codemie
|
|
278
|
+
# Refresh expired tokens
|
|
279
|
+
codemie auth refresh
|
|
207
280
|
|
|
208
|
-
#
|
|
209
|
-
codemie
|
|
281
|
+
# Logout and clear credentials
|
|
282
|
+
codemie auth logout
|
|
210
283
|
```
|
|
211
284
|
|
|
212
|
-
###
|
|
213
|
-
|
|
214
|
-
```bash
|
|
215
|
-
# CodeMie Native - Interactive mode
|
|
216
|
-
codemie-code
|
|
285
|
+
### Token Management
|
|
217
286
|
|
|
218
|
-
|
|
219
|
-
codemie-code --task "Your task here"
|
|
287
|
+
SSO tokens are automatically managed but you can control them manually:
|
|
220
288
|
|
|
221
|
-
|
|
222
|
-
codemie-code "Your initial message"
|
|
289
|
+
#### Token Refresh
|
|
223
290
|
|
|
224
|
-
|
|
225
|
-
codemie-code health
|
|
291
|
+
AI/Run CodeMie CLI automatically refreshes tokens when they expire. For manual refresh:
|
|
226
292
|
|
|
227
|
-
|
|
228
|
-
|
|
293
|
+
```bash
|
|
294
|
+
# Refresh SSO credentials (extends session)
|
|
295
|
+
codemie auth refresh
|
|
229
296
|
```
|
|
230
297
|
|
|
231
|
-
|
|
298
|
+
**When to refresh manually:**
|
|
299
|
+
- Before long-running tasks
|
|
300
|
+
- After extended periods of inactivity
|
|
301
|
+
- When you receive authentication errors
|
|
302
|
+
- Before important demonstrations
|
|
303
|
+
|
|
304
|
+
#### Authentication Status
|
|
232
305
|
|
|
233
|
-
|
|
306
|
+
Check your current authentication state:
|
|
234
307
|
|
|
235
308
|
```bash
|
|
236
|
-
|
|
237
|
-
codemie-claude # Interactive mode
|
|
238
|
-
codemie-claude --model claude-4-5-sonnet # Override model
|
|
239
|
-
codemie-claude --api-key your-key # Override API key
|
|
240
|
-
codemie-claude health # Health check
|
|
241
|
-
|
|
242
|
-
# Codex (direct shortcut)
|
|
243
|
-
codemie-codex # Interactive mode
|
|
244
|
-
codemie-codex --model gpt-4o # Override model (OpenAI only)
|
|
245
|
-
codemie-codex --provider openai # Override provider
|
|
246
|
-
codemie-codex health # Health check
|
|
309
|
+
codemie auth status
|
|
247
310
|
```
|
|
248
311
|
|
|
249
|
-
**
|
|
250
|
-
-
|
|
251
|
-
-
|
|
252
|
-
-
|
|
253
|
-
-
|
|
254
|
-
- Pass through unknown options to the underlying agent
|
|
312
|
+
**Status information includes:**
|
|
313
|
+
- Connection status to AI/Run CodeMie SSO
|
|
314
|
+
- Token validity and expiration
|
|
315
|
+
- Available models for your account
|
|
316
|
+
- Provider configuration details
|
|
255
317
|
|
|
256
|
-
|
|
318
|
+
#### Token Troubleshooting
|
|
319
|
+
|
|
320
|
+
Common authentication issues and solutions:
|
|
257
321
|
|
|
258
322
|
```bash
|
|
259
|
-
#
|
|
260
|
-
codemie
|
|
323
|
+
# Token expired
|
|
324
|
+
codemie auth refresh
|
|
261
325
|
|
|
262
|
-
#
|
|
263
|
-
codemie
|
|
326
|
+
# Connection issues
|
|
327
|
+
codemie doctor # Full system diagnostics
|
|
328
|
+
codemie auth status # Check auth-specific issues
|
|
264
329
|
|
|
265
|
-
#
|
|
266
|
-
codemie
|
|
330
|
+
# Complete re-authentication
|
|
331
|
+
codemie auth logout
|
|
332
|
+
codemie auth login --url https://your-airun-codemie-instance.com
|
|
267
333
|
|
|
268
|
-
# Reset configuration
|
|
334
|
+
# Reset all configuration
|
|
269
335
|
codemie config reset
|
|
270
|
-
|
|
271
|
-
# Advanced: Change timeout (default: 300 seconds)
|
|
272
|
-
codemie config set timeout 600
|
|
336
|
+
codemie setup # Run wizard again
|
|
273
337
|
```
|
|
274
338
|
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
## ⚙️ Configuration
|
|
339
|
+
### Enterprise SSO Features
|
|
278
340
|
|
|
279
|
-
CodeMie
|
|
341
|
+
AI/Run CodeMie SSO provides enterprise-grade features:
|
|
280
342
|
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
"baseUrl": "https://api.anthropic.com/v1",
|
|
287
|
-
"apiKey": "your-api-key",
|
|
288
|
-
"timeout": 300
|
|
289
|
-
}
|
|
290
|
-
}
|
|
291
|
-
```
|
|
343
|
+
- **Secure Token Storage**: Credentials stored in system keychain
|
|
344
|
+
- **Automatic Refresh**: Seamless token renewal without interruption
|
|
345
|
+
- **Multi-Model Access**: Access to Claude, GPT, and other models through unified gateway
|
|
346
|
+
- **Audit Logging**: Enterprise audit trails for security compliance
|
|
347
|
+
- **Role-Based Access**: Model access based on organizational permissions
|
|
292
348
|
|
|
293
|
-
|
|
349
|
+
## Examples
|
|
294
350
|
|
|
295
|
-
|
|
296
|
-
- **openai** - OpenAI API
|
|
297
|
-
- **azure** - Azure OpenAI
|
|
298
|
-
- **bedrock** - AWS Bedrock
|
|
299
|
-
- **litellm** - LiteLLM Proxy (custom)
|
|
351
|
+
### Common Workflows
|
|
300
352
|
|
|
301
|
-
|
|
353
|
+
```bash
|
|
354
|
+
# Code review workflow
|
|
355
|
+
codemie-code "Review this PR for security issues and performance"
|
|
302
356
|
|
|
303
|
-
|
|
357
|
+
# Bug fixing
|
|
358
|
+
codemie-claude -p "Fix the authentication bug in src/auth.ts"
|
|
304
359
|
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
export ANTHROPIC_BASE_URL="https://api.anthropic.com/v1"
|
|
308
|
-
export ANTHROPIC_API_KEY="your-api-key"
|
|
309
|
-
export ANTHROPIC_MODEL="claude-4-5-sonnet"
|
|
360
|
+
# Test generation
|
|
361
|
+
codemie-codex --task "Generate comprehensive tests for the API endpoints"
|
|
310
362
|
|
|
311
|
-
#
|
|
312
|
-
|
|
313
|
-
export OPENAI_API_KEY="your-api-key"
|
|
314
|
-
export OPENAI_MODEL="gpt-4"
|
|
363
|
+
# Documentation
|
|
364
|
+
codemie-code "Document the functions in utils/helpers.js"
|
|
315
365
|
|
|
316
|
-
#
|
|
317
|
-
|
|
318
|
-
export AI_API_KEY="your-api-key"
|
|
319
|
-
export AI_MODEL="your-model"
|
|
366
|
+
# Refactoring
|
|
367
|
+
codemie-claude -p "Refactor this component to use React hooks"
|
|
320
368
|
```
|
|
321
369
|
|
|
322
|
-
|
|
370
|
+
### Configuration Examples
|
|
323
371
|
|
|
324
|
-
|
|
372
|
+
```bash
|
|
373
|
+
# Setup with different providers
|
|
374
|
+
codemie config set provider openai
|
|
375
|
+
codemie config set model gpt-4o
|
|
376
|
+
codemie config set apiKey sk-your-key
|
|
325
377
|
|
|
326
|
-
|
|
378
|
+
# Temporary model override
|
|
379
|
+
codemie-claude --model claude-4-5-sonnet -p "Explain this algorithm"
|
|
327
380
|
|
|
328
|
-
|
|
381
|
+
# Debug mode for troubleshooting
|
|
382
|
+
codemie-code --debug --task "analyze performance issues"
|
|
383
|
+
```
|
|
329
384
|
|
|
330
|
-
|
|
331
|
-
```bash
|
|
332
|
-
# Interactive mode
|
|
333
|
-
codemie run codemie-code
|
|
385
|
+
### Advanced Usage
|
|
334
386
|
|
|
335
|
-
|
|
336
|
-
|
|
387
|
+
```bash
|
|
388
|
+
# Run specific agent versions
|
|
389
|
+
codemie run claude --version latest
|
|
337
390
|
|
|
338
|
-
#
|
|
339
|
-
codemie-
|
|
391
|
+
# Pass custom arguments
|
|
392
|
+
codemie-codex --temperature 0.1 --max-tokens 2000 "Generate clean code"
|
|
340
393
|
|
|
341
|
-
#
|
|
342
|
-
codemie
|
|
394
|
+
# Health checks
|
|
395
|
+
codemie doctor # Full system check
|
|
396
|
+
codemie-code health # Built-in agent check
|
|
397
|
+
codemie-claude health # Claude agent check
|
|
343
398
|
```
|
|
344
399
|
|
|
345
|
-
|
|
346
|
-
- 🔧 **Built-in**: No installation required - ready to use immediately
|
|
347
|
-
- 🚀 **Modern UI**: Beautiful terminal interface with real-time streaming
|
|
348
|
-
- 🎯 **Task-focused**: Execute single tasks or start interactive sessions
|
|
349
|
-
- 🔍 **Debug Mode**: Comprehensive logging with `--debug` flag
|
|
350
|
-
- 📋 **Clipboard Support**: Automatic image detection from clipboard
|
|
351
|
-
- 🛠️ **System Tools**: File operations, git integration, and command execution
|
|
352
|
-
- 💬 **Interactive Chat**: Continuous conversations with context memory
|
|
353
|
-
- 📊 **Usage Statistics**: Token tracking and cost monitoring
|
|
354
|
-
|
|
355
|
-
**Direct Commands:**
|
|
356
|
-
```bash
|
|
357
|
-
# Health check
|
|
358
|
-
codemie-code health
|
|
400
|
+
## Agents
|
|
359
401
|
|
|
360
|
-
|
|
361
|
-
codemie-code --debug
|
|
402
|
+
### CodeMie Native (Built-in)
|
|
362
403
|
|
|
363
|
-
|
|
364
|
-
|
|
404
|
+
LangGraph-based coding assistant with no installation required.
|
|
405
|
+
|
|
406
|
+
**Features:**
|
|
407
|
+
- Modern terminal UI with streaming responses
|
|
408
|
+
- File operations, git integration, command execution
|
|
409
|
+
- Clipboard support with automatic image detection
|
|
410
|
+
- Interactive conversations with context memory
|
|
411
|
+
- Task-focused execution mode
|
|
412
|
+
- Debug mode with comprehensive logging
|
|
413
|
+
|
|
414
|
+
**Usage:**
|
|
415
|
+
```bash
|
|
416
|
+
codemie-code # Interactive mode
|
|
417
|
+
codemie-code --task "task" # Single task
|
|
418
|
+
codemie-code --debug # Debug mode
|
|
365
419
|
```
|
|
366
420
|
|
|
367
421
|
### Claude Code
|
|
368
422
|
|
|
369
|
-
Anthropic's official CLI
|
|
423
|
+
Anthropic's official CLI with advanced code understanding.
|
|
370
424
|
|
|
371
|
-
**Installation:**
|
|
372
|
-
```bash
|
|
373
|
-
codemie install claude
|
|
374
|
-
```
|
|
425
|
+
**Installation:** `codemie install claude`
|
|
375
426
|
|
|
376
427
|
**Features:**
|
|
377
|
-
- Advanced code understanding
|
|
378
|
-
- Multi-file editing
|
|
379
|
-
- Interactive conversations
|
|
428
|
+
- Advanced code understanding and generation
|
|
429
|
+
- Multi-file editing capabilities
|
|
380
430
|
- Project-aware context
|
|
431
|
+
- Interactive conversations
|
|
381
432
|
|
|
382
433
|
### Codex
|
|
383
434
|
|
|
384
|
-
OpenAI's code generation assistant
|
|
435
|
+
OpenAI's code generation assistant optimized for completion tasks.
|
|
385
436
|
|
|
386
|
-
**Installation:**
|
|
387
|
-
```bash
|
|
388
|
-
codemie install codex
|
|
389
|
-
```
|
|
437
|
+
**Installation:** `codemie install codex`
|
|
390
438
|
|
|
391
439
|
**Features:**
|
|
392
|
-
- Code completion
|
|
393
|
-
- Function generation
|
|
394
|
-
-
|
|
395
|
-
-
|
|
440
|
+
- Code completion and generation
|
|
441
|
+
- Function generation and bug fixing
|
|
442
|
+
- Code explanation and documentation
|
|
443
|
+
- **Requires OpenAI-compatible models only**
|
|
396
444
|
|
|
397
|
-
|
|
398
|
-
- ✅ Supports: GPT models (gpt-5, gpt-5-codex, gpt-4.1, gpt-4o)
|
|
399
|
-
- ❌ Not supported: Claude/Anthropic models (API incompatibility)
|
|
445
|
+
## Troubleshooting
|
|
400
446
|
|
|
401
|
-
|
|
447
|
+
### Command Not Found
|
|
402
448
|
|
|
403
|
-
|
|
449
|
+
```bash
|
|
450
|
+
# Re-link the package
|
|
451
|
+
npm link
|
|
452
|
+
which codemie
|
|
404
453
|
|
|
405
|
-
|
|
454
|
+
# Check installation
|
|
455
|
+
npm list -g @codemieai/code
|
|
456
|
+
```
|
|
406
457
|
|
|
407
|
-
###
|
|
458
|
+
### Configuration Issues
|
|
408
459
|
|
|
409
|
-
```
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
│ │ ├── index.ts # CLI setup
|
|
419
|
-
│ │ └── commands/ # Command implementations
|
|
420
|
-
│ ├── env/ # Environment management
|
|
421
|
-
│ └── utils/ # Utilities
|
|
422
|
-
├── package.json
|
|
423
|
-
└── README.md
|
|
460
|
+
```bash
|
|
461
|
+
# Run setup wizard
|
|
462
|
+
codemie setup
|
|
463
|
+
|
|
464
|
+
# Check current config
|
|
465
|
+
codemie config list
|
|
466
|
+
|
|
467
|
+
# Reset if needed
|
|
468
|
+
codemie config reset
|
|
424
469
|
```
|
|
425
470
|
|
|
426
|
-
###
|
|
471
|
+
### Connection Problems
|
|
427
472
|
|
|
428
473
|
```bash
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
npm run lint # Check code style
|
|
432
|
-
npm run lint:fix # Fix linting issues
|
|
433
|
-
```
|
|
474
|
+
# Run diagnostics
|
|
475
|
+
codemie doctor
|
|
434
476
|
|
|
435
|
-
|
|
477
|
+
# Test specific agent
|
|
478
|
+
codemie-code health
|
|
479
|
+
codemie-claude health
|
|
436
480
|
|
|
437
|
-
|
|
481
|
+
# Debug mode for detailed logs
|
|
482
|
+
codemie-code --debug
|
|
483
|
+
```
|
|
484
|
+
|
|
485
|
+
### Agent Installation Failures
|
|
438
486
|
|
|
439
487
|
```bash
|
|
440
|
-
#
|
|
441
|
-
|
|
488
|
+
# Check internet connection
|
|
489
|
+
curl -I https://api.github.com
|
|
442
490
|
|
|
443
|
-
#
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
491
|
+
# Clear npm cache
|
|
492
|
+
npm cache clean --force
|
|
493
|
+
|
|
494
|
+
# Retry installation
|
|
495
|
+
codemie install claude
|
|
447
496
|
```
|
|
448
497
|
|
|
449
|
-
|
|
498
|
+
### Model Compatibility Errors
|
|
450
499
|
|
|
451
|
-
|
|
500
|
+
When you see "Model not compatible" errors:
|
|
452
501
|
|
|
453
|
-
|
|
502
|
+
1. Check your configured model: `codemie config get model`
|
|
503
|
+
2. Run the agent to see compatible options
|
|
504
|
+
3. Set a compatible model: `codemie config set model gpt-4o`
|
|
505
|
+
4. Or override temporarily: `codemie-codex --model gpt-4o`
|
|
454
506
|
|
|
455
|
-
|
|
456
|
-
```bash
|
|
457
|
-
npm link
|
|
458
|
-
which codemie
|
|
459
|
-
```
|
|
507
|
+
## Development
|
|
460
508
|
|
|
461
|
-
###
|
|
509
|
+
### Project Structure
|
|
462
510
|
|
|
463
|
-
Run the setup wizard:
|
|
464
|
-
```bash
|
|
465
|
-
codemie setup
|
|
466
511
|
```
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
codemie
|
|
512
|
+
codemie-code/
|
|
513
|
+
├── bin/ # Executable entry points
|
|
514
|
+
│ ├── codemie.js # Main CLI
|
|
515
|
+
│ ├── codemie-code.js # Built-in agent
|
|
516
|
+
│ ├── codemie-claude.js # Claude shortcut
|
|
517
|
+
│ └── codemie-codex.js # Codex shortcut
|
|
518
|
+
├── src/
|
|
519
|
+
│ ├── agents/ # Agent registry and adapters
|
|
520
|
+
│ ├── cli/ # CLI command implementations
|
|
521
|
+
│ ├── env/ # Environment and config management
|
|
522
|
+
│ ├── workflows/ # Workflow management
|
|
523
|
+
│ ├── tools/ # VCS tools management
|
|
524
|
+
│ └── utils/ # Shared utilities
|
|
525
|
+
└── tests/ # Test files
|
|
471
526
|
```
|
|
472
527
|
|
|
473
|
-
###
|
|
528
|
+
### Building
|
|
474
529
|
|
|
475
|
-
Check your internet connection and try again:
|
|
476
530
|
```bash
|
|
477
|
-
|
|
531
|
+
npm run build # Compile TypeScript
|
|
532
|
+
npm run dev # Watch mode
|
|
533
|
+
npm run lint # Check code style
|
|
534
|
+
npm run test # Run tests
|
|
535
|
+
npm run ci # Full CI pipeline
|
|
478
536
|
```
|
|
479
537
|
|
|
480
|
-
###
|
|
538
|
+
### Testing
|
|
481
539
|
|
|
482
|
-
Verify your configuration:
|
|
483
540
|
```bash
|
|
541
|
+
npm run build && npm link
|
|
542
|
+
codemie --help
|
|
484
543
|
codemie doctor
|
|
544
|
+
codemie-code health
|
|
485
545
|
```
|
|
486
546
|
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
## 📄 License
|
|
547
|
+
## License
|
|
490
548
|
|
|
491
549
|
Apache-2.0
|
|
492
550
|
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
## 🤝 Contributing
|
|
496
|
-
|
|
497
|
-
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
|
|
498
|
-
|
|
499
|
-
---
|
|
500
|
-
|
|
501
|
-
## 🔗 Links
|
|
551
|
+
## Links
|
|
502
552
|
|
|
503
553
|
- [GitHub Repository](https://github.com/codemie-ai/codemie-code)
|
|
504
554
|
- [Issue Tracker](https://github.com/codemie-ai/codemie-code/issues)
|
|
505
|
-
- [NPM Package](https://www.npmjs.com/package/@codemieai/code)
|
|
555
|
+
- [NPM Package](https://www.npmjs.com/package/@codemieai/code)
|