Chris Hendrickson
0ad1fae213
Metadata: - Bump dew CLI version 0.0.1 → 1.0.0 - Add repository + issue_tracker URLs to all pubspec.yaml files - Switch inter-package path deps to versioned deps (^1.0.0) - Remove publish_to: none from all packages - Add MIT LICENSE to root and all packages - Confirm all four pub.dev names available (dew, dew_core, dew_kanban, dew_mcp) Documentation: - Add CHANGELOG.md (Keep a Changelog format, full 1.0.0 feature history) - Overhaul README.md (pitch, pub.dev badge, quick-start, feature sections) - Add TUI section + full keybinding tables to docs/features/kanban.md - Add CONTRIBUTING.md (setup, test, lint, branch strategy, command guide) Tests: - Add packages/cli/test/cli_test.dart (6 smoke tests) - Add packages/kanban/test/integration_test.dart (6 TicketStore e2e tests) - Expand packages/mcp/test/mcp_test.dart (5 tool registration tests) - Add dew_kanban as dev dependency in packages/mcp/pubspec.yaml - 57/57 tests passing Code quality: - dart format applied across all 23 changed source files - dart analyze: zero errors, zero warnings Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# Dew
|
|
|
|
[](https://pub.dev/packages/dew)
|
|
|
|
**Dew** is a git-native project management CLI for developers who want a kanban board that lives in their repository and talks to AI agents. Tickets are plain Markdown files with YAML frontmatter — diff-friendly, grep-able, and version-controlled alongside your code.
|
|
|
|
## Features
|
|
|
|
### Kanban CLI
|
|
|
|
16 subcommands cover the full lifecycle of a ticket:
|
|
|
|
```
|
|
create list get update delete move
|
|
search comment archive unarchive link unlink
|
|
stats board config tui
|
|
```
|
|
|
|
Tickets are stored as `.project/kanban/<column>/<ID>.md` files. Labels, milestones, typed bidirectional links, and inline comments are all first-class citizens. See the [Kanban documentation](./docs/features/kanban.md) for the full command reference.
|
|
|
|
### Interactive TUI
|
|
|
|
`dew kanban tui` opens a full Trello-style terminal board with three modes:
|
|
|
|
- **Board** — navigate columns and tickets, create/edit/move/archive/delete, live search filter
|
|
- **Detail** — scrollable view of a ticket's body and comments
|
|
- **Editor** — in-terminal modal for editing all ticket fields; opens `$VISUAL`/`$EDITOR` for the body
|
|
|
|
The TUI auto-refreshes when ticket files change on disk, so it stays in sync whether you're editing files directly or an AI agent is updating them.
|
|
|
|
### MCP Server
|
|
|
|
`dew mcp serve` starts an MCP-compliant stdio server that exposes every kanban command as an MCP tool. AI agents (GitHub Copilot, Claude, etc.) can create tickets, move cards, search, and comment — using the exact same logic as the CLI. No separate tool definitions needed: every command that mixes in `DewToolCommand` is registered automatically. See the [MCP documentation](./docs/features/mcp.md).
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
dart pub global activate dew
|
|
```
|
|
|
|
Requires Dart SDK ^3.11.4.
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
# Scaffold a new project (creates .project/dew.yaml)
|
|
dew init .
|
|
|
|
# Create your first ticket
|
|
dew kanban create --title "My first ticket" --type task
|
|
|
|
# Open the interactive board
|
|
dew kanban tui
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Dew reads `.project/dew.yaml` for board columns, ticket types, ID prefix, and MCP server settings. Running `dew init .` generates this file with defaults. See the [Configuration documentation](./docs/config.md) for the full schema reference.
|
|
|
|
## Documentation
|
|
|
|
- [Full documentation index](./docs/index.md)
|
|
- [Kanban board](./docs/features/kanban.md) — CLI commands, TUI keybindings, ticket format
|
|
- [MCP server](./docs/features/mcp.md) — AI agent integration
|
|
- [Configuration reference](./docs/config.md)
|