Metadata-Version: 2.4
Name: agentplan
Version: 0.8.1
Summary: A shared to-do list for AI agents. Dependency-aware task queue, zero dependencies, pure Python.
Author-email: Dushyant Garg <dushyantgarg3@gmail.com>
License: MIT
Project-URL: Homepage, https://fraction12.github.io/agentplan/
Project-URL: Repository, https://github.com/fraction12/agentplan
Project-URL: Documentation, https://fraction12.github.io/agentplan/quickstart.html
Project-URL: Bug Tracker, https://github.com/fraction12/agentplan/issues
Project-URL: Changelog, https://github.com/fraction12/agentplan/blob/main/CHANGELOG.md
Keywords: ai-agent,agent,multi-agent,task-queue,project-management,cli,automation,orchestration,ticket-tracking,dependency-graph,llm,claude,codex,openai,anthropic,ai-coordination,agent-framework,sqlite,zero-dependencies
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Provides-Extra: dashboard
Requires-Dist: flask>=3.0; extra == "dashboard"
Dynamic: license-file

agentplan
  
Asana for AI agents.

agentplan is a shared task system for multiple AI agents working on the same project.

- persistent project + ticket queue
- dependency tracking
- ticket ownership + history
- web dashboard for visibility
- local-first SQLite storage

## Install

```bash
pip install agentplan
```

## Quickstart

```bash
# Create a project with starter tickets
agentplan create "Ship v1" \
  --ticket "Set up database" \
  --ticket "Implement API" \
  --ticket "Write tests"

# See what's ready
agentplan next ship-v1

# Claim work
agentplan claim ship-v1 --agent dash

# Mark complete
agentplan ticket done ship-v1 1 --agent dash
```

## Agent Loop Demo

```bash
agentplan next ship-v1
agentplan claim ship-v1 --agent dash
agentplan ticket done ship-v1 1 --agent dash
```

## Core CLI commands

### Project lifecycle
- `agentplan create`
- `agentplan list`
- `agentplan status`
- `agentplan close`
- `agentplan archive`
- `agentplan remove`

### Ticket workflow
- `agentplan ticket add|list|start|done|skip|block|fail|review|edit|update`
- `agentplan next`
- `agentplan claim`
- `agentplan search`
- `agentplan note`
- `agentplan attach`
- `agentplan history`

### Dependencies + logs
- `agentplan depend`
- `agentplan undepend`
- `agentplan log`

### Utilities
- `agentplan dashboard`
- `agentplan setup`
- `agentplan version`
- `agentplan completion`

## Dashboard

Run the web dashboard:

```bash
agentplan dashboard
```

Open `http://127.0.0.1:5001` to view projects, ticket board state, and activity.

## AI tool setup

### Claude Code plugin

```bash
/install-plugin github:fraction12/agentplan
```

Or copy manually:

```bash
cp -r plugins/claude-code ~/.claude/plugins/agentplan
```

### Codex skill

```bash
mkdir -p ~/.codex/skills/agentplan
cp plugins/codex/SKILL.md ~/.codex/skills/agentplan/
```

### OpenClaw skill

```bash
clawhub install agentplan
```

## Notes on advanced orchestration

AgentPlan also contains advanced orchestration/routing surfaces for power users. These are intentionally de-emphasized in the primary UX and documentation.

## Security + docs

- Security policy: `docs/security/security.md`
- Privacy: `docs/security/privacy.md`
- Marketplace docs: `docs/marketplace/`

## License

MIT
