AI Commands

wit ai <command> [options]

wit ai "your question or command"
wit ai chat <query>
wit ai ask <query>

# Ask questions about your code
wit ai "what files have changed?"
wit ai "show me the last 5 commits"
wit ai "explain what this repository does"

# Execute commands via natural language
wit ai "create a branch for the login feature"
wit ai "stage all TypeScript files"

wit ai commit [options]

# Generate message and create commit (default behavior)
wit ai commit

# Stage all files first, then commit
wit ai commit -a

# Preview the message without committing
wit ai commit --dry-run

# Stage all and preview
wit ai commit -a --dry-run

feat: Add user authentication

- Implement JWT tokens
- Add login/logout endpoints
- Add session management

Signed-off-by: Your Name <email@example.com>

wit ai review [options]

# Review all changes (staged + unstaged)
wit ai review

# Review only staged changes
wit ai review --staged

Code Review Results
────────────────────────────────────────────────────

src/auth.ts:42
  ⚠️  SECURITY: Password is logged in plain text
  Consider removing or masking sensitive data in logs.

src/api/handler.ts:15-20
  💡 SUGGESTION: Error handling could be more specific
  Catching all errors with a generic handler may hide issues.

src/utils/helpers.ts:8
  ✓ GOOD: Nice use of early returns for readability

Overall: 2 issues, 1 suggestion

wit ai explain [ref]

# Explain the last commit
wit ai explain

# Explain a specific commit
wit ai explain abc1234

# Explain a tagged release
wit ai explain v1.0.0

# Explain a commit from 3 commits ago
wit ai explain HEAD~3

Explaining commit abc1234...

This commit adds user authentication to the application.

What it does:
  - Implements JWT-based authentication
  - Adds login and logout API endpoints
  - Creates middleware for protected routes

Why it was made:
  - Adds security to the application
  - Enables user-specific features
  - Required for the upcoming user dashboard

Files affected:
  - src/auth.ts (new)
  - src/middleware/auth.ts (new)
  - src/routes/index.ts (modified)

wit ai resolve [file]

# Get help resolving all conflicts
wit ai resolve

# Resolve a specific file
wit ai resolve src/config.ts

Resolving: src/config.ts

Analysis:
  Our version (main):
    - Sets timeout to 30 seconds
    - Uses new API endpoint format

  Their version (feature-branch):
    - Sets timeout to 60 seconds
    - Adds retry configuration

Suggestion:
  The feature branch's longer timeout and retry logic
  complement the main branch's API changes. Recommend
  merging both changes.

RESOLVED:
```typescript
export const config = {
  timeout: 60,  // Longer timeout from feature branch
  apiEndpoint: '/api/v2',  // New format from main
  retries: 3,  // New from feature branch
  retryDelay: 1000,
};

wit ai status

wit AI Status

Available: Yes
Model: openai/gpt-4o
Provider: openai

Environment Variables:
  OPENAI_API_KEY: Set
  ANTHROPIC_API_KEY: Not set
  WIT_AI_MODEL: (not set, using default)

# OpenAI (GPT models)
export OPENAI_API_KEY=sk-...

# Anthropic (Claude models)
export ANTHROPIC_API_KEY=sk-ant-...

# Use a specific model
export WIT_AI_MODEL=openai/gpt-4o-mini
export WIT_AI_MODEL=anthropic/claude-3-sonnet

# Create a feature branch
wit switch -c feature/user-auth

# Make changes...

# Review your changes before committing
wit ai review

# Generate commit message and commit
wit ai commit -a

# Explain what you did (for PR description)
wit ai explain HEAD

# Start a merge
wit merge feature-branch

# Conflict detected! Get AI help
wit ai resolve

# Review the AI's suggestions, then mark resolved
wit add .
wit merge --continue

# Ask the AI about your current state
wit ai "what's my current status?"
wit ai "summarize my recent commits"
wit ai "what branches do I have?"