Metadata-Version: 2.4
Name: monoco-toolkit
Version: 0.3.0
Summary: Agent Native Toolkit for Monoco - Task Management & Kanban for AI Agents
Project-URL: Homepage, https://monoco.io
Project-URL: Repository, https://github.com/IndenScale/Monoco
Project-URL: Documentation, https://monoco.io/docs
Project-URL: Issues, https://github.com/IndenScale/Monoco/issues
Author-email: Monoco Team <dev@monoco.io>
License-Expression: MIT
License-File: LICENSE
Keywords: agent-native,ai-agents,cli,kanban,monoco,task-management,workflow
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Groupware
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: fastapi>=0.100.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: sse-starlette>=1.6.0
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: uvicorn[standard]>=0.20.0
Requires-Dist: watchdog>=6.0.0
Description-Content-Type: text/markdown

# Monoco Toolkit

[![Version](https://img.shields.io/pypi/v/monoco-toolkit)](https://pypi.org/project/monoco-toolkit/)
[![License](https://img.shields.io/github/license/IndenScale/Monoco)](LICENSE)

> **The Operating System for Agentic Engineering.**
>
> Ground your AI Agents into deterministic workflows. Turn vague "chats" into structured, validatable, and shippable engineering units.

---

## ⚡️ Why Monoco?

In the era of LLMs, the bottleneck isn't **intelligence**—it's **control**.

Generating code is easy. Managing the lifecycle of thousands of agent-generated tasks, validating their outputs, and maintaining a coherent project state is hard. **Monoco** is the missing control plane that bridges the gap between raw AI velocity and strict engineering rigor.

Monoco handles the **"BizOps Logic"** of your development process, allowing you to orchestrate human and AI labor within a unified, version-controlled environment.

## 🌟 Core Features

### 1. Issue as Code (IaaC)

Treat your project management like your code.

- **Markdown Native**: All tasks (Epics, Features, Chores) are stored as structured Markdown files in your repository.
- **Git Backed**: Version control your roadmap. Review changes to requirements via Pull Requests.
- **Universal Context**: Provides a standardized, hallucination-free state representation for AI Agents.

### 2. The Agent Cockpit (VS Code Extension)

Stop context switching. Manage your entire agentic workflow directly inside your editor.

- **Native Kanban Board**: Visualize and drag-and-drop tasks without leaving VS Code.
- **Hierarchical Tree View**: Drill down from high-level Epics to atomic Implementation Tasks.
- **Agent Integration**: Bind specific Agent Providers (Gemini, Claude, etc.) to specific tasks.

### 3. Traceable Execution

- **Deterministic State Machine**: Every task follows a strict lifecycle (Proposed -> Approved -> Doing -> Review -> Done).
- **Audit Trails**: Agents log their actions and decisions directly into the task file.
- **Sanity Checks**: Built-in linters ensure your task definitions are complete and valid before execution.

## 🚀 Quick Start

### Installation

Monoco is available as a Python CLI tool.

```bash
pip install monoco-toolkit
```

### Initialization

Turn any directory into a Monoco workspace.

```bash
monoco init
```

### Workflow

1.  **Plan**: Create a new feature request.
    ```bash
    monoco issue create feature -t "Implement Dark Mode"
    ```
2.  **Start**: Create a feature branch automatically.
    ```bash
    monoco issue start FEAT-001 --branch
    ```
3.  **Code & Sync**: Track modified files automatically.
    ```bash
    monoco issue sync-files
    ```
4.  **Visualize**: Open the board in VS Code or via CLI.
    ```bash
    # Starts the local server
    monoco serve
    ```

## 📦 Extension for VS Code

The **Monoco VS Code Extension** is the primary visual interface for the toolkit.

- **Install from Marketplace**: Search for `Monoco`.
- **Keybinding**: `Cmd+Shift+P` -> `Monoco: Open Kanban Board`.

## 🛠️ Tech Stack & Architecture

- **Core**: Python (CLI & Logic Layer)
- **Extension**: TypeScript (VS Code Client & LSP)
- **Data**: Local Filesystem (Markdown/YAML)

## 🤝 Contributing

Monoco is designed for the community. We welcome contributions to both the core CLI and the VS Code extension.

## 📄 License

MIT © [IndenScale](https://github.com/IndenScale)
