npm i -g cline

npx cline "Your task here"

cline

cline "Create a hello world function in Python"

cat requirements.txt | cline "Analyze these dependencies for security issues"

cline task "Add TypeScript types to this module"
cline t "Fix the bug in auth.js"

# Plan mode with verbose output
cline task -p -v "Design a REST API for user management"

# Yolo mode for automated workflows
cline task -y "Run tests and fix any failures"

# Use specific model with extended thinking
cline task -m claude-sonnet-4-5-20250929 --thinking "Refactor this architecture"

# Resume a previous task
cline task -T abc123def "Now add unit tests"

cline history
cline h -n 20 -p 2

cline config

# Interactive wizard
cline auth

# Quick setup
cline auth -p anthropic -k sk-ant-xxxxx -m claude-sonnet-4-5-20250929
cline auth -p openai-native -k sk-xxxxx -m gpt-4o

# OpenAI-compatible with custom base URL
cline auth -p openai -k your-key -m llama-3 -b https://api.example.com/v1

cline version

cline update

cline -a "Build a new feature"

cline -p "Design the authentication system"

# Analyze file contents
cat README.md | cline "Summarize this documentation"

# Review git changes
git diff | cline "Review these changes and suggest improvements"

# Process command output
npm audit | cline "Fix the security vulnerabilities"

# Combine piped input with a prompt
echo "function add(a, b) { return a + b }" | cline "Add TypeScript types"

# Explicit flag
cline task -i screenshot.png diagram.jpg "Fix the UI based on these images"

# Inline reference
cline "Implement the design shown in @./mockup.png"

cline --json "What files are in this directory?" | jq '.text'

{
  "type": "say",
  "text": "I found 10 files in the current directory...",
  "ts": 1704067200000,
  "reasoning": "Optional reasoning text",
  "say": "completion_result",
  "partial": false,
  "files": ["file1.js", "file2.ts"]
}

# Resume without additional input
cline -T abc123def

# Resume with follow-up message
cline -T abc123def "Now add error handling"

# Resume in plan mode
cline -T abc123def -p "What's left to implement?"

# Resume with yolo mode
cline -T abc123def -y "Continue the implementation"

#!/bin/bash
if cline -y --json "Run the test suite" | jq -e '.text | contains("All tests passed")'; then
  echo "Tests passed!"
else
  echo "Tests failed"
  exit 1
fi

# In GitHub Actions or similar
cline -y --timeout 300 "Fix linting errors in the codebase"

for file in src/*.js; do
  cline -y "Add JSDoc comments to $file"
done

export CLINE_DIR=/custom/config/path
cline "Your task"

# Allow only npm and git commands
export CLINE_COMMAND_PERMISSIONS='{"allow": ["npm *", "git *"]}'

# Deny dangerous commands
export CLINE_COMMAND_PERMISSIONS='{"deny": ["rm -rf *", "sudo *"]}'

# Allow file operations with redirects
export CLINE_COMMAND_PERMISSIONS='{"allow": ["cat *", "echo *"], "allowRedirects": true}'

{
  "allow": ["pattern1", "pattern2"],
  "deny": ["pattern3"],
  "allowRedirects": true
}

~/.cline/
├── data/
│   ├── globalState.json     # Global settings
│   ├── secrets.json         # API keys (encrypted)
│   ├── workspace/           # Workspace state
│   └── tasks/               # Task history
└── log/                     # Debug logs

cline dev log

# Verify configuration
cline config

# Re-authenticate
cline auth

# Check verbose output
cline -v "Your task"

# View logs
cline dev log