Use Cases Features CLI

AI-Powered Terminal Assistant

Code faster, debug smarter, and refactor effortlessly. Paws understands your entire codebase and helps you work without leaving your terminal.

500+ Models Zero Config Secure Open Source
~/project
$ paws
> Can you explain how to authentication system works?
Analyzing project structure...
Found auth-related files: src/auth/*, middleware/auth.ts
✓ Analysis complete. The auth system uses JWT tokens with refresh rotation...
$ paws -p "Add error handling to this function"
Use Cases

What Can You Do With Paws?

Practical solutions for everyday development challenges

🔍

Code Understanding

Get detailed explanations of how systems work in your codebase, including component relationships and data flow.

"Explain how the authentication system works"

Implement Features

Get suggestions and code for new features based on your existing project structure and patterns.

"Add a dark mode toggle to our React app"
🐛

Debug Issues

Analyze errors, identify potential causes in your code, and propose solutions.

"TypeError: Cannot read property 'map' of undefined"
👁️

Code Reviews

Analyze code for readability, performance, security, and maintainability improvements.

"Review src/components/UserProfile.js"
📚

Learn Technologies

Get tailored tutorials for integrating new technologies into your specific project.

"Integrate GraphQL into this Express app"
🗄️

Database Design

Design schemas, tables, relationships, indexes, and constraints for your project.

"Design a blog schema with users, posts, comments"
🔧

Refactor Code

Modernize legacy code with step-by-step refactoring guidance and implementation.

"Refactor this class component to React Hooks"
🌿

Git Operations

Get help with git conflicts, merging, branching, and understanding differences.

"Resolve merge conflicts in feature/user-profile"
Features

Built for Developers

Powerful features that keep you in your flow

Streaming Tokens

Real-time token streaming for instant feedback and smoother interactions

🔄

Persistent Spinner

Always know what's happening with a responsive status indicator

🧠

Smart Thinking Buffer

Shows reasoning only when needed, in a finite preview window

📊

Max Information Density

UI optimized to show more information without clutter

🗑️

Auto-Erase Summary

Summary automatically clears after next prompt to keep context fresh

💬

Full History Access

Switch conversations and see complete history instantly

🖥️

Adaptive Display

Full screen refresh on resize for optimal viewing

⚙️

Zero Configuration

Just add your API key and you're ready to go

🔐

Secure by Design

Your code stays on your machine, only API calls leave

🌐

Multi-Provider Support

Use OpenAI, Anthropic, Google, or 500+ other providers

🤖

Custom Agents

Create and use custom AI agents for specialized tasks

🔑

Interactive Provider Login

Easy credential management with paws provider login

CLI

Command-Line Options

Quick reference for Paws CLI commands

Option Description
-p, --prompt <PROMPT> Direct prompt to process without entering interactive mode
-c, --command <COMMAND> Path to a file containing initial commands to execute
-w, --workflow <WORKFLOW> Path to a file containing workflow to execute
-e, --event <EVENT> Dispatch an event to workflow
--conversation <CONVERSATION> Path to a file containing conversation to execute
-r, --restricted Enable restricted shell mode for enhanced security
--verbose Enable verbose output mode
-h, --help Print help information
-V, --version Print version
Providers

Supported AI Providers

Access 500+ models from multiple AI providers

OpenAI Anthropic Google Vertex AI Google Gemini Xiaomi AI Studio OpenCode Zen Copilot Antigravity xAI (Grok) Groq Cerebras IO Intelligence z.ai Requesty OpenRouter Amazon Bedrock + 500+ more models
Configuration

Customize Paws

Configure Paws behavior with paws.yaml and environment variables

Custom Rules

custom_rules: |
  1. Always add comprehensive error handling
  2. Include unit tests for all new functions
  3. Follow naming convention: camelCase for vars

Model Settings

model: claude-3.7-sonnet
temperature: 0.7
max_walker_depth: 3
max_requests_per_turn: 50
max_tool_failure_per_turn: 3

Custom Commands

commands:
  - name: "refactor"
    description: "Refactor selected code"
    prompt: "Improve readability and performance"

Environment Variables

FORGE_RETRY_MAX_ATTEMPTS=3
FORGE_HTTP_READ_TIMEOUT=900
FORGE_TOOL_TIMEOUT=300
FORGE_MAX_CONVERSATIONS=100
FORGE_SHOW_TASK_STATS=true
MCP

Model Context Protocol

Connect AI agents to external tools and services

MCP allows Paws to communicate with external systems, enabling web browser automation, API interactions, and custom service integrations.

CLI Commands

paws mcp list - List all MCP servers
paws mcp add - Add a new server
paws mcp add-json - Add server via JSON
paws mcp get - Get server details
paws mcp remove - Remove a server

.mcp.json

// MCP server configuration
{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-puppeteer"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/path/to/files"]
    },
    "custom_api": {
      "url": "http://localhost:3000/events"
    }
  }
}