Documentation

v2.0.0

Welcome to Agentwise documentation. Learn how to harness the power of multi-agent orchestration to accelerate your development workflow with verified 64.6% token reduction (up to 94.8% with 10 agents).

Installation

Get Agentwise up and running in minutes

Get started

Quick Start

Your first project with Agentwise

Get started

Commands Reference

Complete guide to all Agentwise commands

Get started

Custom Agents

Create your own specialized AI agents

Get started

Prerequisites

Before getting started with Agentwise, ensure you have the following:

  • Node.js 18+ (Required)
  • Claude Code CLI (Required)
  • Git (Recommended)
  • Basic CLI familiarity

🎉 NEW: Works Without --dangerously-skip-permissions!

Agentwise now includes sandboxed execution with automatic permission handling:

bash
# Works without any flags!
claude /create "my amazing app"

# Old way (still supported but not needed):
claude --dangerously-skip-permissions

✅ Automatic Permission Handling: Responds to prompts intelligently

✅ Workspace Sandboxing: Restricts execution to safe directories

✅ Smart Safety Modes: Configurable levels of automation

âš¡ Quick Installation

🚀 One-Click Setup for Claude Code
Recommended

Copy this prompt and paste into Claude Code for automatic setup:

Setup Prompt
Please set up Agentwise by:
1. Clone: git clone https://github.com/VibeCodingWithPhil/agentwise.git ~/agentwise
2. Install: cd ~/agentwise && npm install && npm run build
3. Configure: Create workspace directory and set up global monitor
4. Start: node dist/index.js
5. Enable sandboxed execution (no --dangerously-skip-permissions needed)

Full setup: https://github.com/VibeCodingWithPhil/agentwise/blob/main/CLAUDE_CODE_SETUP_PROMPT.md

macOS/Linux

One-line installer
curl -fsSL https://raw.githubusercontent.com/VibeCodingWithPhil/agentwise/main/installers/install.sh | bash

Windows

PowerShell (as Administrator)
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/VibeCodingWithPhil/agentwise/main/installers/install.ps1" -OutFile "install.ps1"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
.\install.ps1

Your First Agentwise Project

1

Start Claude Code (no flags needed!)

bash
claude

Agentwise handles permissions automatically

2

Verify installation

bash
/help

You should see Agentwise commands listed.

3

Create your first project

bash
/create "a todo app with React and Firebase"
4

Monitor progress

bash
/monitor

Opens the dashboard at http://localhost:3001

System Architecture

Understanding how Agentwise orchestrates multiple AI agents for optimal performance:

System Architecture Overview

Loading diagram...

What's Next?

Performance

Learn about token optimization and benchmarks

View metrics

Custom Agents

Create specialized agents for your workflow

Create agents

Examples

Explore real-world usage examples

See examples

Community & Support

Need help or want to contribute? Join our community: