lissue

lissue (short for Local Issue) is a powerful, Git-friendly local TODO CLI designed for developers and AI coding agents. It manages your project tasks using a hybrid storage of SQLite (for speed) and JSON (for Git-based sharing).

Demo

Why lissue?

The name lissue comes from "Local Issue". It aims to bring the powerful issue-tracking experience of GitHub/GitLab directly to your local terminal, enabling seamless collaboration between humans and AI agents through Git.

Key Features

Hybrid Storage: Fast local operations with SQLite + Git-syncable JSON storage.
Git-Optimized: "1 Task per File" architecture prevents merge conflicts.
AI-Ready: Specialized commands for AI agents, including context dumping and auto-locking.
Hierarchical Tasks: Support for parent-child relationships and tree view display.
Secure: Built-in protection against path traversal and SQL injection.
Flexible: Editor integration, file movement tracking, and extensive filtering.

Installation

From crates.io (Recommended)

cargo install lissue

From Source

# Clone the repository
git clone https://github.com/Morishita-mm/rust-todo-cli
cd rust-todo-cli

# Install locally
cargo install --path .

Quick Start

Initialize the repository in your project root:
```
lissue init
```

Add a task:

lissue add "Main task" -m "Main description"
# Add a subtask to ID 1 with related files
lissue add "Sub task" -p 1 -f src/main.rs -f src/lib.rs
# Or just 'lissue add' to open your $EDITOR

List tasks:
```
lissue list --tree
```
Claim a task (for AI agents or team members):
```
lissue claim 1 --by "Agent-Alpha"
```
Sync with Git (Apply merged JSON files to your local database):
```
lissue sync
```

Command Reference

Command	Options	Description
`lissue init`		Initialize `.lissue` directory and database.
`lissue add [TITLE]`	`-m`, `-p`, `-f`	Add a new task. `-p`: parent ID, `-f`: linked file.
`lissue list`	`-f`, `-t`, `-s`, `-u`	List tasks. `-t`: tree, `-s`: status, `-u`: unassigned.
`lissue next`		Get the next available task (Open & Unassigned).
`lissue claim <ID>`	`--by`	Mark task as In Progress and assign to yourself/agent.
`lissue close <ID>`		Close a task.
`lissue open <ID>`		Reopen a closed task.
`lissue link <ID>`	`--to`	Create a parent-child relationship.
`lissue context <ID>`		Dump task details and linked file contents for AI.
`lissue mv <OLD> <NEW>`		Move a file and update all linked tasks.
`lissue rm <ID>`		Permanently remove a task.
`lissue clear`		Permanently remove all closed tasks.

Help and Discoverability

You can explore all available commands and options using:

lissue help: List all available subcommands.
lissue <COMMAND> --help: Show detailed help for a specific subcommand (e.g., lissue add --help).

Configuration

Settings are stored in .lissue/config.yaml:

output.default_format: human or json
output.auto_sync: Enable/disable implicit sync during list or next.
integration.git_mv_hook: Use git mv during lissue mv.
context.strategy: paths_only or raw_content.

License

MIT OR Apache-2.0

lissue 0.1.1