Metadata-Version: 2.4
Name: monoco-toolkit
Version: 0.3.10
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 Distro

[![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 Headless Operating System for Agentic Engineering.**
>
> Monoco is a **Linux-like Distribution** for AI Agents.
> It provides the **Package Manager**, **Init System**, and **Policy Kit** that turns a raw LLM Kernel into a production-ready engineering workforce.

---

## 🐧 The "Distro" Metaphor

Monoco is built on a clear separation of concerns, inspired by the Linux ecosystem:

| Component   | In Linux      | In Monoco             | Responsibility                                                                                                             |
| :---------- | :------------ | :-------------------- | :------------------------------------------------------------------------------------------------------------------------- |
| **Kernel**  | Linux Kernel  | **Kimi CLI / Kosong** | The raw execution engine. Handles LLM prompts, tool execution, and process isolation.                                      |
| **Distro**  | Ubuntu / Arch | **Monoco**            | The system manager. Orchestrates workflows, enforces policies, manages state (Issues), and installs capabilities (Skills). |
| **Desktop** | GNOME / KDE   | **VSCode / Zed**      | The user interface. Connects to Monoco via standard protocols (LSP, ACP) to provide a visual experience.                   |

## 🌟 Core Philosophy

### 1. Headless & Protocol-First

Monoco is designed to run silently in the background. It doesn't fight for your attention with a chat window. Instead, it exposes its state via **LSP (Language Server Protocol)** and **ACP (Agent Client Protocol)**, allowing your favorite IDEs to become "Agent-Native".

### 2. Issue is the Unit of Work

Just as `systemd` manages Units, Monoco manages **Issues**.
An Issue is not just a text file; it is a stateful object that defines the lifecycle of a task. The Agent cannot "freelance"—it must be assigned to an active Issue.

### 3. Governance as Code

Monoco acts as the "Policy Kit" for your AI workforce.

- **Guardrails**: Prevent destructive actions.
- **Verification**: Enforce linting and tests before submission.
- **Audit**: Log every decision and tool call.

## 🚀 Quick Start

### 1. Installation

Install the Monoco Distro via pip:

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

### 2. Initialize System

Turn your project into a Monoco-managed workspace:

```bash
monoco init
```

### 3. Sync Kernel

Inject Monoco's policies into your Agent Kernel (e.g., Kimi CLI configuration):

```bash
monoco sync
```

### 4. Start a Session

Launch the Monoco Daemon to begin orchestrating work:

```bash
monoco session start
```

## 🛠️ Tech Stack & Architecture

- **Kernel Interface**: Python (Interfacing with Kimi/Kosong)
- **Distro Logic**: Python (State Management, Issue Tracking)
- **Protocols**: LSP / ACP (for IDE integration)
- **Storage**: Local Filesystem (Markdown/YAML)

## 🤝 Contributing

Monoco is open-source. We are building the standard distribution for the Agentic era.

## 📄 License

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