Metadata-Version: 2.4
Name: tasktree-cli
Version: 1.0.0
Summary: Agent-native CLI for TaskTree — a tree-based task management platform
Author-email: Frank <mirzatsoft@gmail.com>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: requests>=2.28
Requires-Dist: rich>=13.0
Dynamic: license-file
Dynamic: requires-python

# TaskTree CLI

Agent-native CLI for TaskTree — a personal tree-based task management app.

## Installation

    pip install tasktree-cli

## Quick Start

    tasktree login -u <username> -p <password>
    tasktree projects list
    tasktree projects create "My Project"
    tasktree tree <project-id>

## Commands

### Auth
- `tasktree login` — Login and cache token
- `tasktree me` — Show current user

### Projects
- `tasktree projects list` — List projects
- `tasktree projects create <name>` — Create project
- `tasktree projects get <id>` — Get project details
- `tasktree projects delete <id>` — Delete project

### Nodes
- `tasktree nodes list -p <id>` — List nodes
- `tasktree nodes create -p <id> -t "Title"` — Create node
- `tasktree nodes update <id> [--status done]` — Update node
- `tasktree nodes delete <id>` — Delete node
- `tasktree nodes move <id> --parent <id>` — Move node
- `tasktree nodes reorder <id> --order <n>` — Reorder

### Edges
- `tasktree edges list -p <id>` — List edges
- `tasktree edges create -p <id> -s <id> -t <id>` — Create edge
- `tasktree edges update <id> -l "label"` — Update edge
- `tasktree edges delete <id>` — Delete edge

### Layout
- `tasktree layout <project-id>` — Auto-layout

### AI Commands
- `tasktree tree <project-id>` — Text tree output
- `tasktree search <project-id> -q "query"` — Search nodes
- `tasktree batch -f ops.json` — Batch operations

### REPL
- `tasktree` — Enter interactive REPL
- `use <project-id>` — Set current project context
- `exit` — Exit REPL

## Flags
- `--json` — Machine-readable JSON output (all commands)
- `--format tree|json|flat` — Output format (projects get)

## Configuration
- Config: `~/.tasktree/config.json`
- Auth: `~/.tasktree/auth.json`
- Env: `TASKTREE_SERVER`, `TASKTREE_TOKEN`

## Exit Codes
- 0: Success
- 1: General error
- 2: Auth error
- 3: API error
- 4: Validation error
