Claude Code Cli Integration

Claude Code CLI Integration Skill

Purpose: Enable Claude Code extension to orchestrate its own CLI for operations requiring unrestricted system access, bypassing VS Code extension permission limitations.

Version: 1.0.0 Auto-Invoke: False (manual activation or SubAgent triggers)

Overview

This Skill enables Claude Code (VS Code extension) to leverage Claude Code CLI for:

• Batch file operations without permission prompts (50+ files)
• System-level configuration and package installation
• Complex workflows requiring both IDE context and system access
• Automation scripts that would be blocked in sandboxed environment

Key Innovation: Self-orchestration - Claude Code extension commands its own CLI for unrestricted operations while maintaining IDE context awareness.

When to Use This Skill

✅ Use Claude Code CLI for:

• Batch operations: 50+ files requiring individual permission prompts
• System access: Package installation, environment configuration
• Automation: Scripts that need unrestricted file system access
• Performance: Bulk processing where speed matters
• Task automation: Bulk task file creation/updates in fstrentspectasks

❌ Don't use Claude Code CLI for:

• Single files: Use extension's native file operations
• Interactive debugging: Requires IDE integration
• Quick edits: Immediate IDE feedback needed
• Small batches: 10
• System access: Yes
• Permission prompts: >5
• Performance critical: Yes

Example: Refactor 150 files, system setup, bulk task creation

Strategy C: Hybrid (Complex Path)

Criteria:

• Context gathering: Extension
• Bulk execution: CLI
• Validation: Extension
• Multi-step workflow: Yes

Example: Complex refactoring with validation, system setup with testing

Command Patterns

Basic Usage

# Simple command
claude-code "Your instruction here"

# With file context
claude-code "Analyze this file" --file path/to/file.py

# With directory context
claude-code "Refactor all Python files" --directory src/

# Dry run first (recommended)
claude-code "Refactor codebase" --dry-run
claude-code "Refactor codebase" --auto-approve  # After review

Integration Patterns

Pattern 1: Batch File Processing

# Extension: Analyze structure
# CLI: Process all files at once
claude-code "Add type hints to all Python files in src/" \
  --directory src/ \
  --auto-approve

Pattern 2: System Configuration

# CLI handles system-level operations
claude-code "Install Python 3.11, uv, configure virtual environment" \
  --auto-approve

Pattern 3: Context Gathering + Execution

# Extension: Generate plan
cat > execution_plan.md  refactor_plan.md  .cache/analysis.json
fi

# Use cached results
claude-code "Refactor based on analysis" \
  --file .cache/analysis.json

Incremental Processing

# Only process changed files
changed_files=$(find src -newer .last_run -name "*.py")
echo "$changed_files" | while read file; do
  claude-code "Process file" --file "$file"
done
date > .last_run

Error Handling

Graceful Degradation

Level 1: Retry with adjusted parameters

if ! claude-code "Process files"; then
  claude-code "Process files" --verbose
fi

Level 2: Break into smaller batches

if ! claude-code "Process all 500 files"; then
  for batch in batch1 batch2 batch3; do
    claude-code "Process batch" --pattern "$batch"
  done
fi

Level 3: Fall back to extension native

if ! claude-code "Critical operation" 2>error.log; then
  echo "Falling back to extension native operations"
  # Extension handles with user approval
fi

Activation

Manual Activation

"Use Claude Code CLI to process all these files"
"Leverage CLI for batch operation"

SubAgent Activation

The claude-code-orchestrator SubAgent automatically activates for:

• Batch operations (>10 files)
• System-level tasks
• Complex multi-step workflows
• Tasks requiring >5 permission prompts

Success Metrics

Quantitative

• ✅ 80% reduction in permission prompts
• ✅ 3x faster execution for 50+ file operations
• ✅ <5 second response time for CLI commands
• ✅ 95%+ success rate for strategy decisions

Qualitative

• ✅ Batch processing without interruption
• ✅ System-level automation from VS Code
• ✅ Intelligent workflow orchestration
• ✅ Security-first command execution

Troubleshooting

Issue: CLI Not Found

# Check installation
which claude-code

# Add to PATH if needed
export PATH="$PATH:/path/to/claude-code"

Issue: Permission Denied

# Check permissions
ls -la /path/to/files

# Fix if needed
chmod +x /path/to/files

Issue: Command Hangs

# Use timeout
timeout 300 claude-code "Operation"

# Use non-interactive mode
claude-code "Operation" --non-interactive

Related Resources

Files

• Rule: .cursor/rules/fstrent_spec_tasks/claude_code_cli.mdc (Cursor version)
• Agent: .cursor/rules/fstrent_spec_tasks/agents/claude_code_orchestrator.mdc (Cursor version)
• SubAgent: .claude/agents/claude-code-orchestrator.md (Claude Code version)
• Rules: .claude/rules/claude_code_cli_integration.md (Claude Code version)
• Documentation: docs/20251028_212220_Cursor_CLAUDE_CODE_CLI_INTEGRATION_GUIDE.md

Related Skills

• fstrent-task-management - Task lifecycle management
• fstrent-planning - Project planning and PRD creation
• web-tools - Browser automation and web scraping
• computer-use - Desktop automation and GUI control

SubAgents

• claude-code-orchestrator - Intelligent CLI orchestration agent

---

Version: 1.0.0 Created: 2025-10-28 Status: Production Ready Testing: Pending real-world validation

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wrm3
• Source: wrm3/aiproject_template
• License: MIT

Install and usage instructions live in the source repository linked above.