pig-coding-agent 0.0.4

Interactive coding agent CLI

pig-coding-agent

Interactive coding agent CLI with file operations and code generation.

Features

• 💻 Code Generation: AI-powered code generation
• 📁 File Operations: Read, write, edit files
• 🔍 Code Analysis: Understand and analyze code
• 🛠️ Refactoring: Automated code refactoring
• 🐚 Shell Integration: Execute shell commands
• 💬 Interactive Chat: Conversational interface
• 🔄 Resilience: Automatic API key rotation and fallback (NEW in v0.0.4)
• 💰 Cost Tracking: Track LLM and tool usage costs (NEW in v0.0.4)

Installation

pip install pig-coding-agent

Quick Start

Start Interactive Session

# Start coding agent
pig-code

# With specific model
pig-code --model gpt-4

# In a specific directory
pig-code --path /path/to/project

Command Line Usage

# Generate code
pig-code gen "Create a FastAPI hello world app"

# Analyze file
pig-code analyze main.py

# Refactor code
pig-code refactor main.py "Add type hints"

# Chat mode
pig-code chat

Built-in Tools

The coding agent comes with these tools:

File Operations

• read_file(path) - Read file contents
• write_file(path, content) - Write to file
• list_files(directory) - List directory contents
• search_files(pattern) - Search for files

Code Operations

• generate_code(description) - Generate code from description
• explain_code(code) - Explain what code does
• fix_code(code, error) - Fix code errors
• add_tests(code) - Generate tests for code

Shell Operations

• run_command(command) - Execute shell command
• git_status() - Get git status
• git_diff() - Get git diff

Usage Examples

Generate a Python Module

$ pig-code
> Create a Python module for handling JSON files with read/write functions

Agent will:
1. Generate the code
2. Write to file
3. Show you the result

Analyze Codebase

$ pig-code analyze
> Analyze this codebase and suggest improvements

Agent will:
1. Read relevant files
2. Analyze structure
3. Provide recommendations

Interactive Refactoring

$ pig-code
> Refactor main.py to use async/await

Agent will:
1. Read the file
2. Refactor the code
3. Show diff
4. Ask for confirmation
5. Write changes

Configuration

Create .pig-code-config.json:

{
  "provider": "openai",
  "model": "gpt-4",
  "temperature": 0.7,
  "max_iterations": 10,
  "auto_confirm": false,
  "workspace": "./",
  "ignore_patterns": [
    "node_modules",
    ".git",
    "__pycache__"
  ]
}

Chat Commands

Inside the agent:

/help       - Show help
/exit       - Exit agent
/clear      - Clear conversation
/files      - List files in workspace
/status     - Show agent status
/resilience - Show resilience status (API keys, rotation)
/cost       - Show cost tracking summary
/usage      - Show usage statistics

Resilience Features (v0.0.4)

The agent now supports automatic resilience for production stability:

API Key Rotation

Set multiple API keys for automatic rotation on rate limits:

export OPENAI_API_KEY=sk-...
export OPENAI_API_KEY_2=sk-...
export OPENAI_API_KEY_3=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
export ANTHROPIC_API_KEY_2=sk-ant-...

The agent will automatically:

• Rotate to next available key on rate limits
• Apply per-failure-type cooldowns (AUTH=5min, RATE_LIMIT=1min, etc.)
• Fall back to alternative models on context overflow

Check Resilience Status

$ pig-code
> /resilience

Resilience Status
─────────────────
Total API keys: 5
Available: 4
In cooldown: 1

Profiles:
1. openai (key #0): ✓
2. openai (key #2): ✓
3. openai (key #3): ✗ (cooldown)
4. anthropic (key #0): ✓
5. anthropic (key #2): ✓

Disable Resilience

pig-code --no-resilience

Cost Tracking (v0.0.4)

Track LLM and tool usage costs automatically:

View Cost Summary

$ pig-code
> /cost

Usage Summary
─────────────
Total LLM calls: 42
Total tool calls: 156
Total tokens: 125,430 in + 38,920 out
Total cost: $2.4580

By Model:
  gpt-4: 15 calls, 45,230 in + 12,450 out, $1.8900
  gpt-3.5-turbo: 27 calls, 80,200 in + 26,470 out, $0.5680

By Tool:
  read_file: 45 calls
  write_file: 23 calls
  run_command: 88 calls

Usage Data Location

Cost data is saved to .agents/usage.json in your workspace.

Disable Cost Tracking

pig-code --no-cost-tracking

Safety Features

• File operation confirmations
• Command execution warnings
• Workspace boundaries
• Backup before overwrite
• Git integration for tracking changes

Architecture

CodingAgent
├── Agent Core (pig-agent-core)
├── LLM Client (pig-llm)
├── TUI (pig-tui)
└── Built-in Tools
    ├── FileTools
    ├── CodeTools
    └── ShellTools

Examples

See examples/coding-agent/:

• generate_app.py - Generate full application
• refactor_demo.py - Code refactoring
• analysis_demo.py - Code analysis

License

MIT