mAIstro

    ▓▓▓▓
   ██  ██   █▀▀▀█
   █ ▀▀ █  █▌█ █▐█
  ▐█    █▌  █▄▄▄█
   █░░░░█    ▀ ▀
   ██  ██

A small CLI for orchestrating Claude Code tasks when one-shot prompts and limited context aren't enough.

One prompt. 5 hours of autonomous coding. A complete iOS app.

mAIstro helps you break large work into explicit, sequential steps, keeping important requirements visible as tasks execute — so Claude Code doesn't lose context or skip constraints.

This is a free tool built to scratch a personal itch and shared for feedback.

Why mAIstro exists

Claude Code works well for focused tasks. It becomes harder when:

• tasks grow beyond a single prompt
• important requirements fall out of context
• earlier decisions get forgotten mid-execution
• the model "optimizes away" steps you actually need

mAIstro introduces a thin orchestration layer that:

• controls execution order
• limits active context per step
• keeps critical constraints explicit

This makes larger tasks more reliable without increasing prompt complexity.

What it does

• Breaks large work into bounded tasks
• Executes tasks sequentially
• Keeps only relevant context active per step
• Preserves requirements and constraints across steps
• Keeps task status visible while execution progresses
• Allows human intervention between tasks

What it does not do

• No web UI
• No SaaS backend
• No long-term memory system
• No autonomous "set it and forget it" agents

mAIstro is intentionally small and explicit.

Installation

Install globally:

npm install -g maistro

Basic usage

Run mAIstro from your project directory:

maistro

Typical flow:

1. Describe your goal or project
2. mAIstro analyzes and breaks it into bounded tasks
3. Review and refine the plan
4. Tasks execute one at a time
5. Each step sees only the context it needs
6. Requirements stay visible throughout execution

Example use cases

• Large refactors with strict constraints
• Multi-step feature implementation
• Codebase analysis → planning → execution
• Any workflow where losing context breaks correctness

Design principles

• Context discipline over giant prompts
• Explicit sequencing over autonomy
• CLI-first and inspectable
• Human-in-the-loop by default

Who this is for

• Developers already using Claude Code
• People hitting context limits on larger tasks
• Anyone tired of repeating requirements in every prompt

If you want a fully autonomous agent with hidden state, this is probably not it.

Status

• actively used
• lightly tested
• evolving through real-world workflows

Expect rough edges.

Claude Code

How Integration Works

mAIstro uses Claude Code CLI to execute each task on your plan. Tasks run non-interactively with:

claude --dangerously-skip-permissions --chrome

• --dangerously-skip-permissions - Allows autonomous execution without confirmation prompts
• --chrome - Enables browser integration for real-time feedback via Chrome extension

Warning: Once execution starts, mAIstro runs autonomously without confirmation prompts. It will attempt to complete all tasks on the plan without asking for permission. Use responsibly and preferably in sandboxed environments (containers, VMs, or isolated directories).

Claude Code Chrome Extension (Recommended)

For the fastest feedback loop, install the Chrome extension:

Claude Code Chrome Extension

This enables real-time browser automation and visual feedback during task execution.

Feedback

This tool exists to answer one question:

Does explicit orchestration help manage Claude Code context for larger tasks?

If you try it and decide the answer is "no", that feedback is just as valuable.

Issues, ideas, and criticism are welcome. Send them my way at [email protected]

License

Copyright (c) 2026 DreamTeam Mobile. All rights reserved.

Permission is granted, free of charge, to use this software for any purpose, including commercial applications, subject to the following conditions:

1. You MAY use this software for personal or commercial purposes.
2. You MAY NOT modify, adapt, or create derivative works.
3. You MAY NOT redistribute, sublicense, or resell this software.
4. You MAY NOT remove or alter any copyright notices.

This software is provided "as is", without warranty of any kind, express or implied. In no event shall the authors be liable for any claim, damages, or other liability arising from the use of this software.