@codemieai/code 0.0.6 → 0.0.8

package/README.md

@@ -54,14 +54,21 @@
 
 ```bash
 codemie [COMMAND] [OPTIONS]
-codemie-code [MESSAGE|--task TASK] [OPTIONS]
+codemie-code [MESSAGE] [OPTIONS]
 codemie-claude [-p MESSAGE] [OPTIONS]
-codemie-codex [MESSAGE|--task TASK] [OPTIONS]
+codemie-codex [-p MESSAGE] [OPTIONS]
 codemie-gemini [-m MODEL] [-p MESSAGE] [OPTIONS]
 ```
 
 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.
 
+All agent shortcuts (`codemie-*`) share common configuration options:
+- `--profile <name>` - Use specific provider profile
+- `--model <model>` - Override model
+- `--api-key <key>` - Override API key
+- `--base-url <url>` - Override base URL
+- `--debug` - Enable debug logging
+
 ## Quick Start
 
 ```bash
@@ -129,12 +136,12 @@ Ready to use immediately - no installation required:
 # Interactive conversation
 codemie-code
 
-# Execute single task
-codemie-code --task "fix bugs in src/utils"
-
 # Start with initial message
 codemie-code "Help me refactor this component"
 
+# Execute single task (via main CLI)
+codemie --task "fix bugs in src/utils"
+
 # Debug mode
 codemie-code --debug
 ```
@@ -147,13 +154,16 @@ Install and run external agents:
 # Install agents
 codemie install claude
 codemie install codex
+codemie install gemini
 
-# Run via shortcuts (recommended)
-codemie-claude -p "Review my API code"
-codemie-codex --task "Generate unit tests"
+# Run via direct shortcuts (recommended)
+codemie-claude "Review my API code"
+codemie-codex "Generate unit tests"
+codemie-gemini "Optimize performance"
 
-# Direct shortcuts are the recommended way
-codemie-claude -p "Fix security issues"
+# With model override
+codemie-claude --model claude-4-5-sonnet "Fix security issues"
+codemie-codex --model gpt-4.1 "Add type annotations"
 ```
 
 ## Commands
@@ -178,25 +188,31 @@ Direct access to agents with automatic configuration:
 
 ```bash
 # Built-in agent
-codemie-code [message]           # Interactive or with initial message
-codemie-code --task "task"       # Single task execution
+codemie-code                     # Interactive mode
+codemie-code "message"           # Start with initial message
 codemie-code health              # Health check
 
-# External agents
-codemie-claude                   # Claude Code agent (interactive)
-codemie-claude -p "message"      # Claude Code agent (print mode)
-codemie-codex [message]          # Codex agent
-codemie-gemini                   # Gemini CLI agent
+# External agents (direct invocation)
+codemie-claude "message"         # Claude Code agent (interactive)
+codemie-claude -p "message"      # Claude Code agent (non-interactive/print mode)
+codemie-codex "message"          # Codex agent (interactive)
+codemie-codex -p "message"       # Codex agent (non-interactive mode)
+codemie-gemini "message"         # Gemini CLI agent
+
+# With agent-specific options (pass-through to underlying CLI)
+codemie-claude --context large -p "review code"
+codemie-codex --temperature 0.1 -p "generate tests"
+codemie-gemini -p "your prompt"  # Gemini's non-interactive mode
 
 # Configuration overrides (model, API key, base URL, timeout)
-codemie-claude --model claude-4-5-sonnet --api-key your-key
-codemie-codex --model gpt-4.1 --base-url https://api.openai.com/v1
-codemie-gemini --model gemini-2.0-flash-exp
+codemie-claude --model claude-4-5-sonnet --api-key your-key "review code"
+codemie-codex --model gpt-4.1 --base-url https://api.openai.com/v1 "generate tests"
+codemie-gemini -m gemini-2.5-flash "optimize performance"
 
 # Profile selection (profiles contain provider + all settings)
-codemie-code --profile work-litellm "task"
-codemie-claude --profile personal-openai -p "message"
-codemie-gemini --profile lite --model gemini-2.5-flash  # Use LiteLLM proxy
+codemie-code --profile work-litellm "analyze codebase"
+codemie-claude --profile personal-openai "review PR"
+codemie-gemini --profile lite --model gemini-2.5-flash "document code"
 ```
 
 ### Configuration Commands
@@ -364,7 +380,7 @@ Location: `~/.codemie/config.json`
 ```json
 {
   "provider": "litellm",
-  "model": "claude-4-5-sonnet",
+  "model": "claude-sonnet-4-5",
   "baseUrl": "https://litellm.codemie.example.com",
   "apiKey": "your-api-key",
   "timeout": 300
@@ -426,7 +442,7 @@ codemie auth logout
 
 ### Token Management
 
-SSO tokens are automatically managed but you can control them manually:
+SSO tokens are automatically managed, but you can control them manually:
 
 #### Token Refresh
 
@@ -497,16 +513,16 @@ AI/Run CodeMie SSO provides enterprise-grade features:
 codemie-code "Review this PR for security issues and performance"
 
 # Bug fixing
-codemie-claude -p "Fix the authentication bug in src/auth.ts"
+codemie-claude "Fix the authentication bug in src/auth.ts"
 
 # Test generation
-codemie-codex --task "Generate comprehensive tests for the API endpoints"
+codemie-codex "Generate comprehensive tests for the API endpoints"
 
 # Documentation
 codemie-code "Document the functions in utils/helpers.js"
 
 # Refactoring
-codemie-claude -p "Refactor this component to use React hooks"
+codemie-claude "Refactor this component to use React hooks"
 ```
 
 ### Configuration Examples
@@ -522,10 +538,10 @@ codemie config test
 codemie config init
 
 # Temporary model override
-codemie-claude --model claude-4-5-sonnet -p "Explain this algorithm"
+codemie-claude --model claude-4-5-sonnet "Explain this algorithm"
 
 # Debug mode for troubleshooting
-codemie-code --debug --task "analyze performance issues"
+codemie-code --debug "analyze performance issues"
 ```
 
 ### Multi-Provider Workflow Examples
@@ -572,14 +588,52 @@ codemie setup
 ### Advanced Usage
 
 ```bash
-# Pass custom arguments to agents
+# Pass custom arguments to agents (unknown options pass through)
 codemie-codex --temperature 0.1 --max-tokens 2000 "Generate clean code"
-codemie-claude -p "Review this code" --context large
+codemie-claude --context large "Review this code"
+
+# Non-interactive mode with -p (useful for CI/CD)
+codemie-claude -p "$(cat prompt.txt)" --max-turns 50
+codemie-codex -p "Generate tests for src/utils" --output json
+
+# Debug logging (writes to ~/.codemie/debug/)
+codemie-claude --debug "analyze codebase"
+codemie-codex --debug "implement feature"
+codemie-code --debug "test task"
+
+# Debug logging (writes to ~/.codemie/debug/)
+codemie-claude --debug "analyze codebase"
+codemie-codex --debug "implement feature"
+codemie-code --debug "test task"
 
 # Health checks
 codemie doctor                   # Full system check
 codemie-code health             # Built-in agent check
 codemie-claude health           # Claude agent check
+codemie-gemini health           # Gemini agent check
+```
+
+### CI/CD Integration Example
+
+```bash
+# GitHub Actions / GitLab CI workflow example
+codemie-claude \
+  --base-url "${CODEMIE_BASE_URL}" \
+  --api-key "${CODEMIE_API_KEY}" \
+  --model "${CODEMIE_MODEL:-claude-4-5-sonnet}" \
+  --provider "litellm" \
+  -p "$(cat /tmp/review-prompt.txt)" \
+  --max-turns "${CODEMIE_MAX_TURNS:-50}" \
+  --dangerously-skip-permissions \
+  --allowedTools "Bash(*),Read(*),Curl(*)" \
+  --debug
+
+# Using profile for CI/CD
+codemie-claude \
+  --profile ci-litellm \
+  -p "Review this PR for security issues" \
+  --max-turns 30 \
+  --debug
 ```
 
 ## Agents
@@ -599,7 +653,8 @@ LangGraph-based coding assistant with no installation required.
 **Usage:**
 ```bash
 codemie-code                    # Interactive mode
-codemie-code --task "task"      # Single task
+codemie-code "task"             # Start with message
+codemie --task "task"           # Single task execution
 codemie-code --debug            # Debug mode
 ```
 
@@ -614,6 +669,15 @@ Anthropic's official CLI with advanced code understanding.
 - Multi-file editing capabilities
 - Project-aware context
 - Interactive conversations
+- Non-interactive mode with `-p` flag
+
+**Usage:**
+```bash
+codemie-claude                   # Interactive mode
+codemie-claude "message"         # Start with message
+codemie-claude -p "message"      # Non-interactive/print mode
+codemie-claude health            # Health check
+```
 
 ### Codex
 
@@ -625,8 +689,17 @@ OpenAI's code generation assistant optimized for completion tasks.
 - Code completion and generation
 - Function generation and bug fixing
 - Code explanation and documentation
+- Non-interactive mode with `-p` flag
 - **Requires OpenAI-compatible models only**
 
+**Usage:**
+```bash
+codemie-codex                    # Interactive mode
+codemie-codex "message"          # Start with message
+codemie-codex -p "message"       # Non-interactive mode
+codemie-codex health             # Health check
+```
+
 ### Gemini CLI
 
 Google's Gemini AI coding assistant with advanced code understanding.
@@ -658,8 +731,151 @@ export GEMINI_API_KEY="your-gemini-api-key-here"
 **Usage:**
 ```bash
 codemie-gemini                          # Interactive mode
-codemie-gemini -m gemini-2.5-flash      # Specify model
-codemie-gemini -p "your prompt"         # Non-interactive mode
+codemie-gemini "your prompt"            # With initial message
+codemie-gemini -p "your prompt"         # Non-interactive mode (Gemini-specific)
+codemie-gemini -m gemini-2.5-flash      # Specify model (Gemini-specific)
+codemie-gemini --model gemini-2.5-flash "analyze code"  # With config override
+```
+
+## Debug Logging
+
+All CodeMie agents support comprehensive debug logging that writes to files.
+
+### Enabling Debug Mode
+
+```bash
+# Using --debug flag (recommended)
+codemie-claude --debug "your task"
+codemie-codex --debug "your task"
+codemie-code --debug "your task"
+
+# Using environment variable
+CODEMIE_DEBUG=1 codemie-claude "your task"
+
+# For entire session
+export CODEMIE_DEBUG=1
+codemie-claude "task 1"
+codemie-codex "task 2"
+```
+
+### Debug Log Files
+
+When debug mode is enabled, each session creates a timestamped directory:
+
+**Location:** `~/.codemie/debug/session-<timestamp>/`
+
+**Log Files:**
+1. **application.log** - All application activity
+   - Contains: Info, warnings, errors, debug messages
+   - Format: Plain text with timestamps
+   - Example: `[2025-11-27T12:30:00.000Z] [INFO] Starting agent...`
+
+2. **requests.jsonl** - HTTP request/response details (ai-run-sso provider only)
+   - Contains: Request/response headers, bodies, timing
+   - Format: JSONL (one JSON object per line)
+   - Security: Sensitive headers automatically redacted
+   - Example: `{"type":"request","requestId":1,"method":"POST",...}`
+
+### Console Output
+
+Debug mode keeps your console clean - you'll only see:
+```bash
+$ codemie-claude --debug "analyze code"
+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
+```
+
+All debug details are written to files in the session directory.
+
+### Analyzing Logs
+
+**Using command-line tools:**
+```bash
+# View latest application log
+tail -f ~/.codemie/debug/session-*/application.log
+
+# Search for errors in latest session
+grep ERROR ~/.codemie/debug/session-*/application.log
+
+# Parse HTTP requests with jq
+cat ~/.codemie/debug/session-*/requests.jsonl | jq 'select(.type == "request")'
+```
+
+**Clean up old logs:**
+```bash
+# Remove session directories older than 7 days
+find ~/.codemie/debug -type d -name "session-*" -mtime +7 -exec rm -rf {} +
+
+# Remove all debug logs
+rm -rf ~/.codemie/debug
+```
+
+## Debug Logging
+
+All CodeMie agents support comprehensive debug logging that writes to files.
+
+### Enabling Debug Mode
+
+```bash
+# Using --debug flag (recommended)
+codemie-claude --debug "your task"
+codemie-codex --debug "your task"
+codemie-code --debug "your task"
+
+# Using environment variable
+CODEMIE_DEBUG=1 codemie-claude "your task"
+
+# For entire session
+export CODEMIE_DEBUG=1
+codemie-claude "task 1"
+codemie-codex "task 2"
+```
+
+### Debug Log Files
+
+When debug mode is enabled, logs are written to a unified session directory:
+
+**Location:** `~/.codemie/debug/session-<timestamp>/`
+
+1. **application.log** - All application logs
+   - Contains: Info, warnings, errors, debug messages
+   - Format: Plain text with timestamps
+
+2. **requests.jsonl** - HTTP request/response details (ai-run-sso provider only)
+   - Contains: Request/response headers, bodies, timing
+   - Format: JSONL (one JSON object per line)
+   - Security: Sensitive headers automatically redacted
+
+### Console Output
+
+Debug mode keeps your console clean - you'll only see:
+```bash
+$ codemie-claude --debug "analyze code"
+Starting Claude Code | Profile: default | Provider: openai | Model: claude-sonnet-4-5 | Debug: /Users/username/.codemie/debug/session-2025-11-27T12-30-00-000Z
+```
+
+All debug details are written to files in the session directory.
+
+### Analyzing Logs
+
+**Using command-line tools:**
+```bash
+# View latest application log
+tail -f ~/.codemie/debug/session-*/application.log
+
+# Search for errors in latest session
+grep ERROR ~/.codemie/debug/session-*/application.log
+
+# Parse HTTP request logs with jq (ai-run-sso only)
+cat ~/.codemie/debug/session-*/requests.jsonl | jq 'select(.type == "request")'
+```
+
+**Clean up old logs:**
+```bash
+# Remove logs older than 7 days
+find ~/.codemie/debug -name "session-*" -mtime +7 -delete
+
+# Remove all debug logs
+rm -rf ~/.codemie/debug
 ```
 
 ## Troubleshooting
@@ -733,19 +949,21 @@ When you see "Model not compatible" errors:
 
 ```
 codemie-code/
-├── bin/                    # Executable entry points
-│   ├── codemie.js         # Main CLI
-│   ├── codemie-code.js    # Built-in agent
-│   ├── codemie-claude.js  # Claude shortcut
-│   └── codemie-codex.js   # Codex shortcut
+├── bin/                       # Executable entry points
+│   ├── codemie.js            # Main CLI
+│   └── agent-executor.js     # Universal agent executor (all shortcuts)
 ├── src/
-│   ├── agents/            # Agent registry and adapters
-│   ├── cli/               # CLI command implementations
-│   ├── env/               # Environment and config management
-│   ├── workflows/         # Workflow management
-│   ├── tools/             # VCS tools management
-│   └── utils/             # Shared utilities
-└── tests/                 # Test files
+│   ├── agents/               # Agent system
+│   │   ├── core/            # Core agent abstractions
+│   │   ├── plugins/         # Plugin-based adapters (claude, codex, gemini, codemie-code)
+│   │   └── codemie-code/    # Built-in agent implementation
+│   ├── cli/                 # CLI commands
+│   │   └── commands/        # Command implementations (setup, doctor, workflow, etc.)
+│   ├── env/                 # Configuration management
+│   ├── workflows/           # CI/CD workflow management
+│   │   └── templates/       # Workflow templates (GitHub Actions, GitLab CI)
+│   └── utils/               # Shared utilities
+└── tests/                   # Test files
 ```
 
 ### Building

package/bin/agent-executor.js

@@ -19,12 +19,14 @@ import { logger } from '../dist/utils/logger.js';
 
 // Detect agent from executable name
 // /usr/local/bin/codemie-claude → 'claude'
-// /usr/local/bin/codemie-code → 'codemie-code' (special case)
+// /usr/local/bin/codemie-code → 'codemie-code' (special case for built-in agent)
+// NOTE: 'codemie-code' constant defined in src/agents/plugins/codemie-code.plugin.ts
 const executableName = basename(process.argv[1]);
+const BUILTIN_AGENT_NAME = 'codemie-code';
 
 let agentName;
-if (executableName === 'codemie-code') {
-  agentName = 'codemie-code'; // Keep full name for built-in agent
+if (executableName === BUILTIN_AGENT_NAME) {
+  agentName = BUILTIN_AGENT_NAME; // Keep full name for built-in agent
 } else {
   agentName = executableName.replace('codemie-', ''); // Strip prefix for external agents
 }
@@ -33,7 +35,7 @@ if (executableName === 'codemie-code') {
 const agent = AgentRegistry.getAgent(agentName);
 
 if (!agent) {
-  logger.error(`Unknown agent: ${agentName}`);
+  logger.error(`Unknown agent '${agentName}'`);
   console.log('Available agents:', AgentRegistry.getAgentNames().join(', '));
   process.exit(1);
 }

package/dist/agents/codemie-code/agent.d.ts.map

@@ -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"}
+{"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"}

package/dist/agents/codemie-code/agent.js

@@ -11,6 +11,7 @@ import { CodeMieAgentError } from './types.js';
 import { extractToolMetadata } from './toolMetadata.js';
 import { extractTokenUsageFromStreamChunk, extractTokenUsageFromFinalState } from './tokenUtils.js';
 import { setGlobalToolEventCallback } from './tools/index.js';
+import { logger } from '../../utils/logger.js';
 export class CodeMieAgent {
     agent;
     config;
@@ -46,7 +47,7 @@ export class CodeMieAgent {
             messageModifier: getSystemPrompt(config.workingDirectory)
         });
         if (config.debug) {
-            console.log(`[DEBUG] CodeMie Agent initialized with ${tools.length} tools`);
+            logger.debug(`CodeMie Agent initialized with ${tools.length} tools`);
         }
     }
     /**
@@ -139,8 +140,8 @@ export class CodeMieAgent {
                 // Check if we have SSO cookies to inject (following codemie-ide-plugin pattern)
                 const ssoCookies = global.codemieSSOCookies;
                 if (this.config.debug) {
-                    console.log(`[DEBUG] SSO Cookies available:`, ssoCookies ? Object.keys(ssoCookies) : 'none');
-                    console.log(`[DEBUG] Auth token:`, this.config.authToken);
+                    logger.debug(`SSO Cookies available:`, ssoCookies ? Object.keys(ssoCookies) : 'none');
+                    logger.debug(`Auth token:`, this.config.authToken);
                 }
                 if (ssoCookies && this.config.authToken === 'sso-authenticated') {
                     // Create custom fetch function that includes SSO cookies (matches oauth2Proxy.js line 134)
@@ -163,23 +164,23 @@ export class CodeMieAgent {
                         // that matches how codemie-claude works through SSO Gateway
                         process.removeAllListeners('warning');
                         if (this.config.debug) {
-                            console.log('[DEBUG] Disabled SSL verification (like SSO Gateway and codemie-model-fetcher)');
+                            logger.debug('Disabled SSL verification (like SSO Gateway and codemie-model-fetcher)');
                         }
                         if (this.config.debug) {
-                            console.log(`[DEBUG] SSO request to ${input}`);
-                            console.log(`[DEBUG] Cookies: ${Object.keys(ssoCookies).join(', ')}`);
-                            console.log(`[DEBUG] Full cookie string length: ${cookieString.length}`);
+                            logger.debug(`SSO request to ${input}`);
+                            logger.debug(`Cookies: ${Object.keys(ssoCookies).join(', ')}`);
+                            logger.debug(`Full cookie string length: ${cookieString.length}`);
                         }
                         try {
                             const response = await fetch(input, updatedInit);
                             if (this.config.debug && !response.ok) {
-                                console.log(`[DEBUG] SSO request failed: ${response.status} ${response.statusText}`);
+                                logger.debug(`SSO request failed: ${response.status} ${response.statusText}`);
                             }
                             return response;
                         }
                         catch (error) {
                             if (this.config.debug) {
-                                console.log(`[DEBUG] SSO request error:`, error);
+                                logger.debug(`SSO request error:`, error);
                             }
                             throw error;
                         }
@@ -198,13 +199,13 @@ export class CodeMieAgent {
                             }
                         };
                         if (this.config.debug) {
-                            console.log(`[DEBUG] Non-SSO LiteLLM request to ${input}`);
-                            console.log(`[DEBUG] Authorization header set with API key`);
+                            logger.debug(`Non-SSO LiteLLM request to ${input}`);
+                            logger.debug(`Authorization header set with API key`);
                         }
                         return fetch(input, updatedInit);
                     };
                     if (this.config.debug) {
-                        console.log(`[DEBUG] LiteLLM provider configured with API key authentication`);
+                        logger.debug(`LiteLLM provider configured with API key authentication`);
                     }
                 }
                 return new ChatOpenAI({
@@ -270,7 +271,7 @@ export class CodeMieAgent {
         const originalSigintHandler = process.listeners('SIGINT');
         const sigintHandler = () => {
             if (this.config.debug) {
-                console.log('\n[DEBUG] Received SIGINT - aborting stream...');
+                logger.debug('\nReceived SIGINT - aborting stream...');
             }
             streamAborted = true;
             abortController.abort();
@@ -279,7 +280,7 @@ export class CodeMieAgent {
         process.once('SIGINT', sigintHandler);
         try {
             if (this.config.debug) {
-                console.log(`[DEBUG] Processing message: ${message.substring(0, 100)}...`);
+                logger.debug(`Processing message: ${message.substring(0, 100)}...`);
             }
             // Add user message to conversation history (with optional images)
             const userMessage = this.createHumanMessage(message, images);
@@ -300,7 +301,7 @@ export class CodeMieAgent {
                 // Check if stream was aborted
                 if (streamAborted || abortController.signal.aborted) {
                     if (this.config.debug) {
-                        console.log('[DEBUG] Stream processing aborted');
+                        logger.debug('Stream processing aborted');
                     }
                     break;
                 }
@@ -313,7 +314,7 @@ export class CodeMieAgent {
                     // Store token usage to associate with next tool call
                     this.currentLLMTokenUsage = tokenUsage;
                     if (this.config.debug) {
-                        console.log(`[DEBUG] Token usage: ${tokenUsage.inputTokens} in, ${tokenUsage.outputTokens} out`);
+                        logger.debug(`Token usage: ${tokenUsage.inputTokens} in, ${tokenUsage.outputTokens} out`);
                     }
                 }
                 this.processStreamChunk(chunk, onEvent, (toolStarted) => {
@@ -374,7 +375,7 @@ export class CodeMieAgent {
             catch {
                 // If getState fails, continue without updating history
                 if (this.config.debug) {
-                    console.log('[DEBUG] Could not get final state, continuing...');
+                    logger.debug('Could not get final state, continuing...');
                 }
             }
             // Finalize execution statistics
@@ -384,9 +385,9 @@ export class CodeMieAgent {
             onEvent({ type: 'thinking_end' });
             onEvent({ type: 'complete' });
             if (this.config.debug) {
-                console.log(`[DEBUG] Agent completed in ${this.stats.executionTime}ms`);
-                console.log(`[DEBUG] Total tokens: ${this.stats.totalTokens} (${this.stats.inputTokens} in, ${this.stats.outputTokens} out)`);
-                console.log(`[DEBUG] Estimated cost: $${this.stats.estimatedTotalCost.toFixed(4)}`);
+                logger.debug(`Agent completed in ${this.stats.executionTime}ms`);
+                logger.debug(`Total tokens: ${this.stats.totalTokens} (${this.stats.inputTokens} in, ${this.stats.outputTokens} out)`);
+                logger.debug(`Estimated cost: $${this.stats.estimatedTotalCost.toFixed(4)}`);
             }
         }
         catch (error) {
@@ -398,7 +399,7 @@ export class CodeMieAgent {
             // Handle AbortError from user interruption gracefully
             if (error instanceof Error && (error.name === 'AbortError' || streamAborted)) {
                 if (this.config.debug) {
-                    console.log('[DEBUG] Stream aborted by user');
+                    logger.debug('Stream aborted by user');
                 }
                 onEvent({
                     type: 'error',
@@ -407,7 +408,7 @@ export class CodeMieAgent {
                 return; // Don't throw error for user interruptions
             }
             if (this.config.debug) {
-                console.error(`[DEBUG] Agent error:`, error);
+                logger.debug(`Agent error:`, error);
             }
             onEvent({
                 type: 'error',
@@ -497,7 +498,7 @@ export class CodeMieAgent {
         }
         catch (error) {
             if (this.config.debug) {
-                console.error(`[DEBUG] Error processing stream chunk:`, error);
+                logger.debug(`Error processing stream chunk:`, error);
             }
             // Don't throw here, just log - let the main stream continue
             onEvent({
@@ -556,7 +557,7 @@ export class CodeMieAgent {
             executionSteps: []
         };
         if (this.config.debug) {
-            console.log('[DEBUG] Conversation history cleared');
+            logger.debug('Conversation history cleared');
         }
     }
     /**
@@ -635,7 +636,7 @@ export class CodeMieAgent {
         this.currentExecutionSteps.push(step);
         this.stats.llmCalls++;
         if (this.config.debug) {
-            console.log(`[DEBUG] Started LLM step ${step.stepNumber} (${llmContext})`);
+            logger.debug(`Started LLM step ${step.stepNumber} (${llmContext})`);
         }
         return step;
     }
@@ -654,10 +655,10 @@ export class CodeMieAgent {
             // Get the stored tool args for enhanced logging
             const toolArgs = this.toolCallArgs.get(toolName);
             if (toolArgs && Object.keys(toolArgs).length > 0) {
-                console.log(`[DEBUG] Started tool step ${step.stepNumber}: ${toolName} ${JSON.stringify(toolArgs)}`);
+                logger.debug(`Started tool step ${step.stepNumber}: ${toolName} ${JSON.stringify(toolArgs)}`);
             }
             else {
-                console.log(`[DEBUG] Started tool step ${step.stepNumber}: ${toolName}`);
+                logger.debug(`Started tool step ${step.stepNumber}: ${toolName}`);
             }
         }
         return step;
@@ -670,7 +671,7 @@ export class CodeMieAgent {
         step.duration = step.endTime - step.startTime;
         if (this.config.debug) {
             const type = step.type === 'llm_call' ? 'LLM' : `Tool (${step.toolName})`;
-            console.log(`[DEBUG] Completed ${type} step ${step.stepNumber} in ${step.duration}ms`);
+            logger.debug(`Completed ${type} step ${step.stepNumber} in ${step.duration}ms`);
         }
     }
     /**