Creating Your First Project

Learn how to create and manage your first Agentwise project with step-by-step guidance.

What You'll Learn

Core Concepts

  • • How agents collaborate automatically
  • • Project structure and organization
  • • Real-time monitoring and progress tracking

Practical Skills

  • • Writing effective project descriptions
  • • Using the monitoring dashboard
  • • Adding features to existing projects

📋 Complete Step-by-Step Guide

~30 seconds
1

Start Claude Code

Launch Claude Code with the required permissions flag

bash
claude --dangerously-skip-permissions

💡 Pro Tips:

  • • Always use this flag - Agentwise won't work without it
  • • Keep Claude Code running throughout your project
  • • You'll see a confirmation message when it starts
~1-2 minutes
2

Create Your Project

Describe your project idea in natural language

bash
/create "a todo app with React and TypeScript"

💡 Pro Tips:

  • • Be specific about technologies you want to use
  • • Mention key features like authentication, database, etc.
  • • Don't worry about technical details - agents will figure it out
~5-15 minutes
3

Watch Agent Collaboration

Observe as 8 specialized agents work together

bash
# Agents will automatically start creating:
# - Project structure
# - Dependencies
# - Core functionality

💡 Pro Tips:

  • • Each agent handles their specialty (frontend, backend, etc.)
  • • You'll see agent-todo folders being created
  • • Progress is tracked automatically
~Throughout project
4

Monitor Progress

Open the real-time monitoring dashboard

bash
/monitor

💡 Pro Tips:

  • • Dashboard opens at http://localhost:3001
  • • See real-time progress from all agents
  • • Watch token usage and optimization
~2-10 minutes
5

Add Features

Enhance your project with additional functionality

bash
/task "add user authentication"

💡 Pro Tips:

  • • Add features to existing projects anytime
  • • Use specific descriptions for better results
  • • Agents will coordinate to avoid conflicts

🎯 Choose Your Project Type

Different project types engage different agents and have varying complexity levels.

Web Application

Medium

Full-stack web apps with modern frameworks

Examples:

/create "React dashboard with charts"
/create "Next.js blog with CMS"
/create "Vue.js e-commerce platform"
Agents: Frontend, Backend, Database, Testing~10-20 minutes

Mobile App

Medium

Cross-platform mobile applications

Examples:

/create "React Native weather app"
/create "Flutter expense tracker"
/create "Expo social media app"
Agents: Mobile, Backend, Database, Testing~15-25 minutes

API Service

Low

Backend APIs and microservices

Examples:

/create "REST API with authentication"
/create "GraphQL server"
/create "Microservice with Redis"
Agents: Backend, Database, Testing, DevOps~5-15 minutes

Desktop App

High

Cross-platform desktop applications

Examples:

/create "Electron text editor"
/create "Tauri system monitor"
/create "Desktop file manager"
Agents: Desktop, Frontend, Testing~20-30 minutes

🛠️ Troubleshooting Common Issues

No agent-todo folders created

Ensure Claude Code started with --dangerously-skip-permissions flag

Monitor dashboard won't open

Install monitor dependencies manually with: cd src/monitor && npm install

Agents seem stuck or inactive

Check project registry with /projects command and reactivate if needed

TypeScript errors during build

Agents will auto-fix most issues, or use npm run build 2>/dev/null to ignore

🎉 Congratulations!

You've successfully created your first Agentwise project! Here's what to explore next:

Learn All CommandsUnderstanding ArchitecturePerformance & OptimizationCreate Custom Agents