Configuration

Configure Agentwise to suit your development workflow and optimize performance.

Configuration Overview

Configuration Files

JSON-based settings and project registry

Environment Variables

System-wide configuration options

Agent Settings

Custom agent definitions and commands

📁 Configuration Files

Agentwise uses several configuration files to manage projects, settings, and agent definitions.

`.agentwise-config.json`

Sandboxed execution and permission bypass configuration

Optional

Location:

~/.agentwise-config.json (User home)

Example:

json

{
  "version": "1.0.0",
  "permissions": {
    "bypassEnabled": true,
    "safetyMode": "moderate",
    "autoResponse": true,
    "restrictedCommands": []
  },
  "workspace": {
    "enableSandbox": true,
    "restrictPaths": true,
    "maxFileSize": 104857600,
    "allowedPaths": ["~/agentwise/workspace"],
    "deniedPaths": ["/etc", "/usr", "/bin", "/sbin"]
  },
  "monitoring": {
    "enableTerminalMonitoring": true,
    "verbosity": "normal",
    "logRetention": 7
  },
  "tokenOptimization": {
    "enabled": true,
    "maxAgents": 5,
    "contextWindow": 8000,
    "cacheEnabled": true
  }
}

`projects.json`

Central project registry with metadata and tracking

Required

Location:

Root directory

Example:

json

{
  "projects": {
    "todo-app": {
      "name": "todo-app",
      "created": "2024-01-15T10:30:00Z",
      "status": "active",
      "phase": "development",
      "agents": ["frontend", "backend", "database"]
    }
  }
}

`config/settings.json`

Global Agentwise configuration and preferences

Optional

Location:

config/settings.json

Example:

json

{
  "tokenOptimization": {
    "enabled": true,
    "maxAgents": 3,
    "contextWindow": 8000
  },
  "monitoring": {
    "autoStart": true,
    "port": 3001
  },
  "agents": {
    "autoRegenerate": true,
    "customPath": ".claude/agents"
  }
}

`.claude/`

Agent definitions and custom commands

Required

Location:

.claude/ directory

Example:

bash

# Directory structure:
.claude/
├── agents/
│   ├── frontend-specialist.md
│   ├── backend-specialist.md
│   └── custom-agent.md
├── commands/
│   ├── custom-create.ts
│   └── custom-deploy.ts
└── config.json

🌍 Environment Variables

Set these environment variables to customize Agentwise behavior and defaults.

`AGENTWISE_HOME`

Optional

Override default installation directory

Example:

export AGENTWISE_HOME="/usr/local/agentwise"

Use case: Path customization

`AGENTWISE_BYPASS_PERMISSIONS`

Optional

Enable permission bypass system globally

Example:

export AGENTWISE_BYPASS_PERMISSIONS="true"

Use case: No --dangerously-skip-permissions needed

`CLAUDE_FLAGS`

Optional

Default flags for Claude Code startup (deprecated - no longer needed)

Example:

export CLAUDE_FLAGS="--dangerously-skip-permissions --debug"

Use case: Legacy startup configuration

`AGENTWISE_DEBUG`

Optional

Enable detailed debug logging

Example:

export AGENTWISE_DEBUG="true"

Use case: Development debugging

`MONITOR_PORT`

Optional

Custom port for monitoring dashboard

Example:

export MONITOR_PORT="3002"

Use case: Port customization

⚙️ Configuration Setup

Follow these steps to properly configure Agentwise for your environment.

Initial Setup

Create basic configuration structure

bash

# Create configuration directory
mkdir -p config

# Initialize projects registry
echo '{"projects": {}}' > projects.json

# Create .claude directory structure  
mkdir -p .claude/agents .claude/commands

Environment Setup

Configure environment variables

bash

# Add to your shell profile (.bashrc, .zshrc, etc.)
export AGENTWISE_HOME=/path/to/agentwise
export CLAUDE_FLAGS="--dangerously-skip-permissions"

# Reload shell
source ~/.zshrc  # or ~/.bashrc

Verify Configuration

Test that everything is properly configured

bash

# Start Claude Code with configuration
claude $CLAUDE_FLAGS

# Test Agentwise commands
/projects
/monitor

Advanced Configuration

For advanced users, additional configuration options are available:

• Custom agent creation with specialized MCPs
• Token optimization fine-tuning
• Monitoring dashboard customization
• Performance analytics configuration

Custom Agents Performance Tuning

🎯 Configuration Complete!

Your Agentwise configuration is now set up. Ready to start building?

Create Your First Project Learn Commands Explore Integrations