Initialize Queen Claude autonomous development system with Queen Styles design system enforcement
npm install @kenkaiiii/queen-initInitialize the Queen Claude autonomous development system in your project.
Queen Claude transforms your development workflow with autonomous AI agents that can work independently on tasks while you sleep. The system is built around the philosophy: "Human sets prompt → goes to bed → LLM handles everything"
``bashInstall globally
npm install -g queen-claude-init
Or run without installing:
`bash
npx queen-claude-init
`What Gets Created
$3
`
your-project/
├── .queen/
│ ├── database.db # SQLite database for all project data
│ ├── config.json # Queen Claude configuration
│ ├── logs/ # System logs
│ ├── worktrees/ # Git worktrees for parallel development
│ └── backups/ # Database backups
└── (your existing project files)
`$3
The initialization creates a complete SQLite database with tables for:- Projects: Project overview and tech stack information
- Tasks: Development tasks with requirements, expected results, and git worktree coordination
- Documentation: Critical project knowledge for AI agents
- Problems & Solutions: Issue tracking and resolution knowledge base
- Agent Sessions: Real-time coordination of multiple AI agents
- Memory: Important knowledge that agents must remember
- Project Context: Current project state and architectural decisions
- Activity Log: Historical record of all agent activities
Features
$3
- Task Requirements: Define what needs to be built
- Expected Results: Specify validation criteria for autonomous completion
- File Associations: Tell agents exactly which files to work with
- Git Worktree Integration: Parallel development in isolated branches$3
- Multi-Agent Support: Multiple AI agents can work simultaneously
- Session Management: Track what each agent is working on
- Real-Time Status: Monitor progress across all active agents
- Conflict Prevention: Separate worktrees prevent code conflicts$3
- Memory System: Store critical patterns, decisions, and team preferences
- Documentation Database: Essential project knowledge for new agents
- Problem-Solution Database: Learn from past issues and solutions
- Context Awareness: Maintain project state and architectural decisions$3
- Branch Management: Automatic numbered feature branches (001-feature-name)
- Isolated Development: Each feature developed in separate worktree
- Merge Coordination: Track branch lifecycle from development to merge
- Parallel Work: Multiple features developed simultaneouslyInitialization Process
The
queen init command will:1. Gather Project Information
- Project name and description
- Main features and tech stack
- Development preferences
2. Create Directory Structure
-
.queen/ directory with subdirectories
- Git worktree management setup3. Initialize Database
- Create all necessary tables
- Insert project metadata
- Add essential documentation
- Store critical memories
4. Generate Configuration
- Agent settings and limits
- Database configuration
- Logging preferences
- Git worktree settings
Configuration
The generated
config.json includes:`json
{
"project": {
"name": "Your Project",
"description": "Project description",
"initialized": "2024-01-01T00:00:00.000Z"
},
"agents": {
"max_concurrent": 3,
"default_agent": "claude",
"session_timeout": 3600000
},
"git": {
"worktree_base": ".queen/worktrees",
"branch_prefix": "",
"auto_cleanup": true
}
}
`Next Steps
After initialization:
1. Create Tasks: Define development work for AI agents
2. Set Up Worktrees: Configure git worktrees for parallel development
3. Launch Agents: Start autonomous development sessions
4. Monitor Progress: Watch agents work through project dashboard
Requirements
- Node.js 18.0 or later
- Git repository (for worktree functionality)
- SQLite compatible environment
Philosophy
Queen Claude is designed for developers who want:
- Autonomous Development: AI agents that work independently
- Parallel Execution: Multiple features developed simultaneously
- Knowledge Continuity: Learning from past work and decisions
- Quality Assurance: Built-in validation and testing
- Minimal Supervision: Set tasks and let agents handle the details
Support
For issues, feature requests, or questions:
- GitHub Issues: queen-claude/initialize-queen
- Documentation: Queen Claude Docs
---
Ready to revolutionize your development workflow? Run
queen init` and let AI agents handle the heavy lifting while you focus on the big picture.