Haconiwa (็ฎฑๅบญ) is an AI collaborative development support Python CLI tool. This next-generation tool integrates tmux company management, git-worktree integration, task management, and AI agent coordination to provide an efficient development environment.
โ ๏ธ Note: This project is currently under active development. Features and APIs may change frequently.
This project follows Semantic Versioning.
- ๐ Changelog: CHANGELOG.md - All version change history
- ๐ท๏ธ Latest Version: 0.3.0
- ๐ฆ PyPI: haconiwa
- ๐ GitHub Releases: Releases
Create and manage a 4x4 grid multi-agent development environment right now:
# 1. Installation
pip install haconiwa
# 2. Create multi-agent environment (4 organizations ร 4 roles = 16 panes)
haconiwa company build --name my-company \
--base-path /path/to/desks \
--org01-name "Frontend Development" --task01 "UI Design" \
--org02-name "Backend Development" --task02 "API Development" \
--org03-name "Database Team" --task03 "Schema Design" \
--org04-name "DevOps Team" --task04 "Infrastructure"
# 3. List companies
haconiwa company list
# 4. Attach to existing company
haconiwa company attach my-company
# 5. Update company settings (organization name changes)
haconiwa company build --name my-company \
--org01-name "New Frontend Team" --task01 "React Development"
# 6. Force rebuild existing company
haconiwa company build --name my-company \
--base-path /path/to/desks \
--org01-name "Renewed Development Team" \
--rebuild
# 7. Terminate company (with directory cleanup)
haconiwa company kill my-company --clean-dirs --base-path /path/to/desks --force
# 8. Terminate company (keep directories)
haconiwa company kill my-company --force๐ Auto-created Directory Structure:
/path/to/desks/
โโโ org-01/
โ โโโ 01boss/ # PM desk
โ โโโ 01worker-a/ # Worker-A desk
โ โโโ 01worker-b/ # Worker-B desk
โ โโโ 01worker-c/ # Worker-C desk
โโโ org-02/
โ โโโ 02boss/
โ โโโ 02worker-a/
โ โโโ 02worker-b/
โ โโโ 02worker-c/
โโโ org-03/ (same structure)
โโโ org-04/ (same structure)
โ Actually Working Features:
- ๐ข Integrated Build Command: Create, update, and rebuild with a single command
- ๐ค Automatic Existence Check: Auto-detect company existence and choose appropriate action
- ๐ Seamless Updates: Safely modify existing company configurations
- ๐จ Force Rebuild: Complete recreation with --rebuild option
- ๐๏ธ Auto Directory Structure: Automatic desk creation by organization/role
- ๐ท๏ธ Custom Organization & Task Names: Dynamic title configuration
- ๐๏ธ Flexible Cleanup: Choose to keep or delete directories
- ๐๏ธ Company Management: Complete support for create/list/attach/delete
- ๐ Auto README Generation: Automatic README.md creation in each desk
- ๐ 4x4 Multi-Agent: Organizational tmux layout (16 panes)
# Simple company creation (default settings)
haconiwa company build --name my-company
# Custom base path specification
haconiwa company build --name my-company --base-path ./workspacehaconiwa company build --name my-company \
--base-path ./workspace \
--org01-name "Frontend Team" --task01 "UI/UX Development" \
--org02-name "Backend Team" --task02 "API Design" \
--org03-name "Infrastructure Team" --task03 "DevOps" \
--org04-name "QA Team" --task04 "Quality Assurance" \
--no-attach # Don't auto-attach after creation# Change organization name only (auto-detect update mode)
haconiwa company build --name my-company \
--org01-name "New Frontend Team"
# Update multiple settings simultaneously
haconiwa company build --name my-company \
--org01-name "React Development Team" --task01 "SPA Application Development" \
--org02-name "Node.js Development Team" --task02 "RESTful API"# Completely recreate existing company
haconiwa company build --name my-company \
--base-path ./workspace \
--org01-name "Renewed Development Team" \
--rebuild# Specify workspace (desk) for each organization
haconiwa company build --name my-company \
--desk01 "react-frontend-desk" \
--desk02 "nodejs-backend-desk" \
--desk03 "docker-infra-desk" \
--desk04 "testing-qa-desk"# Terminate company (delete tmux session only, keep directories)
haconiwa company kill my-company --force
# Complete deletion (delete directories too)
haconiwa company kill my-company \
--clean-dirs \
--base-path ./workspace \
--forceThe build command automatically detects company existence status and chooses the appropriate action:
| Situation | Action | Example Message |
|---|---|---|
| Company doesn't exist | New Creation | ๐๏ธ Building new company: 'my-company' |
| Company exists + configuration changes | Update | ๐ Updating existing company: 'my-company' |
| Company exists + no configuration changes | Information Display | โน๏ธ No changes specified for company 'my-company' |
| --rebuild option specified | Force Rebuild | ๐ Rebuilding company: 'my-company' |
Issue: Company not responding
# 1. Check company status
haconiwa company list
# 2. Force terminate
haconiwa company kill my-company --force
# 3. Recreate
haconiwa company build --name my-company --rebuildIssue: Directory permission errors
# Check and fix base path permissions
chmod 755 ./workspace
haconiwa company build --name my-company --base-path ./workspaceIssue: tmux session remains
# Manually check tmux sessions
tmux list-sessions
# Manual deletion
tmux kill-session -t my-company- ๐ค AI Agent Management: Create and monitor Boss/Worker agents
- ๐ฆ World Management: Build and manage development environments
- ๐ฅ๏ธ tmux Company Integration: Efficient development space management
- ๐ Task Management: Task management system integrated with git-worktree
- ๐ Resource Management: Efficient scanning of databases and file paths
- ๐๏ธ Real-time Monitoring: Progress monitoring of agents and tasks
| tmux Concept | Haconiwa Concept | Description |
|---|---|---|
| Session | Company | Top-level management unit representing entire project |
| Window | Room | Functional work areas for specific roles and functions |
| Pane | Desk | Individual workspaces for concrete task execution |
Company
โโโ Building โ Logical management layer (tmux-independent)
โ โโโ Floor โ Logical management layer (tmux-independent)
โ โโโ Room โ tmux Window
โ โโโ Desk โ tmux Pane
Logical Management Layer Features:
- Building: Major project categories (Frontend Building, Backend Building, etc.)
- Floor: Functional classifications (Development Floor, Testing Floor, Deploy Floor, etc.)
- These layers are managed logically within haconiwa without direct tmux company mapping
Organization
โโโ PM (Project Manager)
โ โโโ Overall coordination
โ โโโ Task assignment
โ โโโ Progress management
โโโ Worker
โโโ Worker-A (Development)
โโโ Worker-B (Testing)
โโโ Worker-C (Deployment)
Role Definitions:
- PM (Boss): Strategic decision-making, resource management, quality assurance
- Worker: Implementation, testing, deployment and other execution tasks
- Organization: Logical team unit composed of multiple PMs/Workers
pip install haconiwa๐ Development Note: The package is available on PyPI, but many features are still under development.
๐ญ Important: The commands shown below are for demonstration purposes. Currently, these commands display help information and basic structure, but the actual functionality is under development. We are actively working toward complete feature implementation.
haconiwa --helphaconiwa core inithaconiwa world create local-dev# Create boss agent
haconiwa agent spawn boss
# Create worker agent
haconiwa agent spawn worker-a# Create new task
haconiwa task new feature-login
# Assign task to agent
haconiwa task assign feature-login worker-a
# Monitor progress
haconiwa watch tail worker-a๐ง Development Note: The commands listed below are currently for demonstration and testing purposes. The CLI structure is functional, but most commands display help information or placeholder responses. We are actively developing the core functionality behind each command group.
The CLI tool provides 7 main command groups:
Manage AI agents (Boss/Worker) for collaborative development
haconiwa agent spawn <type>- Create agenthaconiwa agent ps- List agentshaconiwa agent kill <name>- Stop agent
System core management and configuration
haconiwa core init- Initialize projecthaconiwa core status- Check system statushaconiwa core upgrade- Upgrade system
Scan and manage project resources (databases, files, etc.)
haconiwa resource scan- Resource scanninghaconiwa resource list- List resources
Efficient development enterprise environment management using tmux
haconiwa company build <name> - Create, update, and rebuild tmux companieshaconiwa company list- List companieshaconiwa company attach <name>- Attach to companyhaconiwa company kill <name>- Terminate/delete companyhaconiwa company resize <name>- Adjust company layout
Task management integrated with git-worktree
haconiwa task new <name>- Create new taskhaconiwa task assign <task> <agent>- Assign taskhaconiwa task status- Check task status
Real-time monitoring of agents and tasks
haconiwa watch tail <target>- Real-time monitoringhaconiwa watch logs- Display logs
Development environment and world management
haconiwa world create <name>- Create new development worldhaconiwa world list- List worldshaconiwa world switch <name>- Switch world
๐ฌ Current Phase: Demonstration & Prototyping
Most CLI commands are currently demonstration placeholders showing the intended structure and help information. We are actively developing the core functionality behind each command.
- Basic CLI structure with 7 command groups
- PyPI package distribution and installation
- Core project initialization framework
- tmux Company Management System (company build command)
- Multi-Agent 4x4 Layout Auto-Construction
- Organization, Task, and Desk Customization Features
- Automatic Company Existence Check and Update Functionality
- Flexible Cleanup System
- Help system and command documentation
- Command group organization and routing
- AI agent generation and management (placeholder โ implementation)
- git-worktree task management integration (placeholder โ implementation)
- Resource scanning functionality (placeholder โ implementation)
- Real-time monitoring system (placeholder โ implementation)
- World/environment management (placeholder โ implementation)
- Advanced AI agent collaboration
- Integration with popular development tools
- Plugin system for extensibility
- Web-based monitoring dashboard
git clone https://github.com/dai-motoki/haconiwa.git
cd haconiwa
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -e .[dev]pytest tests/MIT License - See LICENSE file for details.
We welcome contributions to the project! As this is an active development project, we recommend:
- Check existing issues and discussions
- Fork this repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Create a Pull Request
- GitHub Issues: Issues
- Email: kanri@kandaquantum.co.jp
This project is in early alpha development and in a demonstration phase. Current CLI commands are primarily placeholders showing the intended interface design. Most functionality is actively under development and not yet implemented.
Currently Working:
- CLI installation and command structure
- Help system and documentation
- Basic command routing
To be Implemented:
- Complete implementation of all advertised features
- AI agent collaboration functionality
- Development tool integrations
- Actual task and company management
Production use is not recommended at this time. This is a development preview showing the intended user experience.
Haconiwa (็ฎฑๅบญ) - The Future of AI Collaborative Development ๐ง