Installation

Get Agentwise up and running in just a few minutes. Follow this step-by-step guide for a smooth installation experience.

Prerequisites

Before installing Agentwise, ensure you have the following prerequisites:

Node.js 18+

Required

JavaScript runtime required for Agentwise

Check if installed:

node --version
Install

Claude Code CLI

Required

Anthropic's official CLI tool

Check if installed:

claude --version
Install

Git

Required

Version control system

Check if installed:

git --version
Install

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

Agentwise now includes automatic permission handling:

No flags needed!
# Just start Claude Code normally:
claude

# Then use Agentwise commands:
claude /create "my amazing app"

Features:

  • ✅ Automatic permission responses
  • ✅ Workspace sandboxing for safety
  • ✅ Terminal output monitoring
  • ✅ Configurable safety modes

Note: The old --dangerously-skip-permissions flag still works if you prefer it.

âš¡ One-Click Setup for Claude Code

🚀 Automated Setup Prompt
Easiest Method

Copy this entire prompt and paste it into Claude Code:

Setup Prompt
I need you to set up Agentwise, a multi-agent orchestration system.

Please perform these steps:
1. Clone: git clone https://github.com/VibeCodingWithPhil/agentwise.git ~/agentwise
2. Install: cd ~/agentwise && npm install && npm run build
3. Create workspace: mkdir -p workspace
4. Install monitor: npm run monitor:install
5. Start Agentwise: node dist/index.js
6. Configure sandboxed execution (no --dangerously-skip-permissions needed)

Full instructions: https://github.com/VibeCodingWithPhil/agentwise/blob/main/CLAUDE_CODE_SETUP_PROMPT.md
View Full Setup Prompt

Alternative Installation Methods

If you prefer manual control or the automated prompt doesn't work:

macOS/Linux

One-command installation

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

Windows

PowerShell as Administrator

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

Manual Installation

If the automated installers don't work, follow these manual steps:

1

Clone the repository

bash
git clone https://github.com/VibeCodingWithPhil/agentwise.git
cd agentwise
2

Install dependencies

bash
npm install
3

Build the project

bash
# Build (ignore TypeScript errors if any)
npm run build 2>/dev/null || true
4

Install monitor dependencies

bash
cd src/monitor
npm install
cd ../..
5

Start Claude Code with required flag

bash
claude --dangerously-skip-permissions

Verify Installation

Follow these steps to ensure Agentwise is properly installed and working:

Check Agentwise commands

In Claude Code, type /helpand verify Agentwise commands are listed.

Test monitor dashboard

bash
/monitor

Should open dashboard at http://localhost:3001

Create a test project

bash
/create "a simple hello world app"

Should start creating agent-todo folders and begin orchestration

Common Issues & Solutions

Command not found: claude

Install Claude Code from https://docs.anthropic.com/en/docs/claude-code

Monitor closes immediately

Install monitor dependencies manually

bash
cd src/monitor
npm install
cd ../..
/monitor

Permission prompts keep appearing

Run 'claude /configure-agentwise' to enable automatic permission handling

No agent-todo folders created

Update to latest version and use /init-import + /task-import

🎉 Installation Complete!

Great! You now have Agentwise installed and ready to use. Here's what to do next:

Quick Start GuideLearn CommandsUnderstanding Architecture