# AI Trackdown PyTools
[](https://pypi.org/project/ai-trackdown-pytools/)
[](https://pypi.org/project/ai-trackdown-pytools/)
[](https://pypi.org/project/ai-trackdown-pytools/)
[](https://github.com/ai-trackdown/ai-trackdown-pytools/actions)
[](https://codecov.io/gh/ai-trackdown/ai-trackdown-pytools)
[](https://opensource.org/licenses/MIT)
[](https://github.com/psf/black)
**Modern Python CLI tools for AI project tracking and task management**
AI Trackdown PyTools brings powerful project management capabilities to your terminal, specifically designed for AI and software development workflows. With beautiful terminal output, intuitive commands, and seamless Git integration, it's the perfect companion for managing complex projects.
## Why AI Trackdown PyTools?
- **🎯 Purpose-Built for AI Projects**: Designed specifically for managing AI and ML project workflows
- **⚡ Fast and Lightweight**: Minimal dependencies, instant startup, no bloat
- **🎨 Beautiful Terminal UI**: Rich formatting, colors, and interactive prompts that make CLI work enjoyable
- **🔧 Extensible Architecture**: Plugin-ready design with customizable templates and workflows
- **🔍 Smart Filtering**: Powerful search and filter capabilities across all your tasks and projects
- **📊 Progress Tracking**: Visual progress indicators and comprehensive status reporting
## Documentation
- 📖 **[User Documentation](docs/user/index.md)** - Installation, usage guides, and command reference
- 🔧 **[Development Documentation](docs/development/index.md)** - Contributing, testing, and release procedures
## Key Features
- 🚀 **Modern CLI Experience** - Built with Typer and Rich for an exceptional terminal experience
- 📋 **Hierarchical Task Management** - Organize tasks, epics, issues, and PRs with parent-child relationships
- 🏗️ **Smart Project Templates** - Pre-configured templates for common AI project structures
- 📝 **Flexible Template System** - Create and share custom templates for any workflow
- 🔍 **Advanced Search** - Filter by status, assignee, tags, priority, and custom fields
- 🎯 **Schema Validation** - Ensure data integrity with JSON schema validation
- 🔧 **Deep Git Integration** - Automatic commit tracking, branch management, and PR linking
- 🔄 **GitHub Sync** - Sync tasks with GitHub issues and pull requests bidirectionally
- 🎨 **Rich Terminal Output** - Tables, progress bars, syntax highlighting, and more
- 🌐 **Multi-Project Support** - Manage multiple projects from a single installation
- 📈 **Analytics and Reporting** - Built-in project analytics and customizable reports
## Installation
### Requirements
- Python 3.8 or higher
- Git (optional, for version control features)
### Install from PyPI
```bash
pip install ai-trackdown-pytools
```
### Install with pipx (Recommended for CLI tools)
```bash
pipx install ai-trackdown-pytools
```
### Install from Source
```bash
git clone https://github.com/ai-trackdown/ai-trackdown-pytools.git
cd ai-trackdown-pytools
pip install -e .
```
### Development Installation
```bash
git clone https://github.com/ai-trackdown/ai-trackdown-pytools.git
cd ai-trackdown-pytools
pip install -e .[dev]
pre-commit install
```
### Verify Installation
```bash
aitrackdown --version
aitrackdown --help
```
## Quick Start
### 1. Initialize Your First Project
```bash
# Create a new directory for your project
mkdir my-ai-project && cd my-ai-project
# Initialize AI Trackdown with interactive setup
aitrackdown init project
# Or use a pre-configured template
aitrackdown init project --template ml-research
```
### 2. Create Your First Task
```bash
# Interactive task creation
aitrackdown create task
# Or create directly with options
aitrackdown create task "Implement data preprocessing pipeline" \
--priority high \
--assignee "alice@team.com" \
--tag "data-pipeline"
```
### 3. View Project Status
```bash
# See all tasks at a glance
aitrackdown status
# Get detailed project overview
aitrackdown status project --detailed
```
## Core Commands
### AI-Friendly Mode
AI Trackdown PyTools supports a plain output mode optimized for AI tools and automated scripts:
```bash
# Use --plain flag for simplified output
aitrackdown --plain version
aitrackdown --plain info
aitrackdown --plain status
# Or set environment variable
export AITRACKDOWN_PLAIN=1
aitrackdown version
# Also respects NO_COLOR standard
export NO_COLOR=1
aitrackdown status
```
The plain mode:
- Removes all color codes and rich formatting
- Simplifies output structure for easier parsing
- Ideal for piping to other tools or AI systems
- Automatically enabled in CI environments
### Task Management
```bash
# Create a new task interactively
aitrackdown create task
# Create task with full details
aitrackdown create task "Implement authentication" \
--description "Add JWT authentication to API endpoints" \
--assignee "john@example.com" \
--tag "backend" --tag "security" \
--priority "high" \
--due "2025-08-15"
# Create from template
aitrackdown create task --template bug-report
# Create subtask under parent
aitrackdown create task "Write unit tests" --parent TSK-0001
```
### View and Filter Tasks
```bash
# List all tasks with rich formatting
aitrackdown status tasks
# Filter by multiple criteria
aitrackdown status tasks \
--status open \
--assignee "john@example.com" \
--tag "backend" \
--priority high
# Search tasks by keyword
aitrackdown search "authentication" --type task
# Show task details
aitrackdown show TSK-0001
# Update task status
aitrackdown update TSK-0001 --status in-progress
```
### Template Management
```bash
# List all available templates
aitrackdown template list
# Show template details
aitrackdown template show bug-report --type task
# Create custom template interactively
aitrackdown template create
# Create template from existing task
aitrackdown template create --from TSK-0001 --name "feature-template"
# Share template
aitrackdown template export feature-template --output feature.yaml
aitrackdown template import feature.yaml
```
### GitHub Sync
```bash
# Check sync status
aitrackdown sync github status
# Push local issues to GitHub (dry-run first)
aitrackdown sync github push --dry-run
aitrackdown sync github push
# Pull GitHub issues to local tasks
aitrackdown sync github pull --dry-run
aitrackdown sync github pull
# Specify repository explicitly
aitrackdown sync github push --repo owner/repo
```
## Complete Command Reference
### Core Commands
| Command | Description | Example |
|---------|-------------|----------|
| `init` | Initialize project or configuration | `aitrackdown init project` |
| `create` | Create tasks, issues, epics, PRs | `aitrackdown create task "New feature"` |
| `status` | Show project and task status | `aitrackdown status tasks --open` |
| `update` | Update existing items | `aitrackdown update TSK-0001 --status done` |
| `show` | Display detailed information | `aitrackdown show TSK-0001` |
| `search` | Search across all items | `aitrackdown search "bug" --type issue` |
| `template` | Manage templates | `aitrackdown template list` |
### Advanced Commands
| Command | Description | Example |
|---------|-------------|----------|
| `epic` | Manage epic tasks | `aitrackdown epic create "Q3 Features"` |
| `pr` | Create and link pull requests | `aitrackdown pr create --branch feature/auth` |
| `migrate` | Migrate from other tools | `aitrackdown migrate --from jira` |
| `sync` | Sync with GitHub issues/PRs | `aitrackdown sync github push` |
| `report` | Generate reports | `aitrackdown report weekly --format html` |
### Utility Commands
| Command | Description | Example |
|---------|-------------|----------|
| `info` | System information | `aitrackdown info` |
| `health` | Health check | `aitrackdown health --verbose` |
| `config` | Configuration management | `aitrackdown config set editor.default "vim"` |
| `export` | Export data | `aitrackdown export --format json` |
### Quick Aliases
- `atd` → `aitrackdown`
- `atd-init` → `aitrackdown init`
- `atd-create` → `aitrackdown create`
- `atd-status` → `aitrackdown status`
## Project Structure
```
my-project/
├── .ai-trackdown/ # Configuration and templates
│ ├── config.yaml # Project configuration
│ ├── project.yaml # Project metadata
│ ├── templates/ # Custom templates
│ └── schemas/ # Custom schemas
├── tasks/ # Task files organized by type
│ ├── tsk/ # Standard tasks
│ ├── epic/ # Epic tasks
│ └── bug/ # Bug reports
├── docs/ # Documentation
└── README.md # Project documentation
```
## Configuration
AI Trackdown PyTools uses YAML configuration files:
### Global Configuration (`~/.ai-trackdown/config.yaml`)
```yaml
version: "1.0.0"
editor:
default: "code" # Default editor for task editing
templates:
directory: "templates"
git:
auto_commit: false
commit_prefix: "[ai-trackdown]"
```
### Project Configuration (`.ai-trackdown/config.yaml`)
```yaml
version: "1.0.0"
project:
name: "My Project"
description: "Project description"
version: "1.0.0"
tasks:
directory: "tasks"
auto_id: true
id_format: "TSK-{counter:04d}"
templates:
directory: "templates"
```
## Templates
Templates are powerful tools for standardizing task creation:
### Task Template Example
```yaml
name: "Bug Report Template"
description: "Template for bug reports"
type: "task"
version: "1.0.0"
variables:
severity:
description: "Bug severity"
default: "medium"
choices: ["low", "medium", "high", "critical"]
component:
description: "Affected component"
required: true
content: |
# Bug: {{ title }}
## Description
{{ description }}
## Severity
{{ severity }}
## Affected Component
{{ component }}
## Steps to Reproduce
1.
2.
3.
## Expected Behavior
## Actual Behavior
## Environment
- OS:
- Browser:
- Version:
```
## Real-World Examples
### Managing an ML Research Project
```bash
# Initialize ML research project
aitrackdown init project --template ml-research
# Create research epic
aitrackdown create epic "Experiment: Vision Transformer Fine-tuning" \
--goal "Achieve 95% accuracy on custom dataset"
# Create subtasks
aitrackdown create task "Prepare dataset" --parent EPIC-0001 --assignee "data-team"
aitrackdown create task "Implement model architecture" --parent EPIC-0001
aitrackdown create task "Run baseline experiments" --parent EPIC-0001
# Track experiment results
aitrackdown update TSK-0003 --add-note "Baseline accuracy: 87.3%"
```
### Bug Tracking Workflow
```bash
# Report a bug
aitrackdown create issue "Model inference crashes on GPU" \
--type bug \
--severity critical \
--component "inference-engine" \
--affects-version "2.1.0"
# Link to PR
aitrackdown create pr "Fix GPU memory leak in inference" \
--fixes BUG-0001 \
--branch hotfix/gpu-memory-leak
```
### Sprint Planning
```bash
# Create sprint epic
aitrackdown create epic "Sprint 23: Authentication & API" \
--start "2025-08-01" \
--end "2025-08-14"
# Bulk assign tasks to sprint
aitrackdown update --tag "sprint-23" --bulk TSK-0001,TSK-0002,TSK-0003
# View sprint progress
aitrackdown status sprint --id 23
```
### Git Integration
Seamlessly integrate with your Git workflow:
```bash
# Initialize with Git integration
aitrackdown init project --git
# Auto-link commits to tasks
git commit -m "feat: Add user authentication
Implements TSK-0001
Co-authored-by: AI Trackdown <ai@trackdown.com>"
# Create PR with task linking
aitrackdown pr create \
--title "Add authentication system" \
--implements TSK-0001,TSK-0002 \
--reviewers "alice,bob"
# Auto-close tasks on merge
aitrackdown config set git.auto_close_on_merge true
```
### Data Validation and Quality
```bash
# Validate all project data
aitrackdown validate
# Validate specific template
aitrackdown template validate feature-template
# Check project health
aitrackdown health --verbose
# Audit project for issues
aitrackdown audit --fix
```
## Plugin System (Coming Soon)
```python
# Example custom plugin
from ai_trackdown_pytools.plugins import Plugin
class JiraImporter(Plugin):
"""Import tasks from Jira."""
def execute(self, context):
# Implementation here
pass
# Register and use
aitrackdown plugin install jira-importer
aitrackdown import --from jira --project "PROJ"
```
## Contributing
We love contributions! AI Trackdown PyTools is a community-driven project, and we welcome contributions of all kinds.
### Ways to Contribute
- 🐛 **Report bugs** and suggest features
- 📖 **Improve documentation** and examples
- 🧪 **Write tests** and improve coverage
- 🎨 **Create templates** for common workflows
- 💻 **Submit pull requests** with enhancements
See our [Contributing Guide](CONTRIBUTING.md) for detailed instructions.
### Quick Development Setup
```bash
# Clone and setup
git clone https://github.com/ai-trackdown/ai-trackdown-pytools.git
cd ai-trackdown-pytools
pip install -e .[dev]
pre-commit install
# Run tests
pytest
# Format code
black src tests
ruff check src tests --fix
```
## Support
### Getting Help
- 📚 [Documentation](https://ai-trackdown-pytools.readthedocs.io/)
- 💬 [Discussions](https://github.com/ai-trackdown/ai-trackdown-pytools/discussions)
- 🐛 [Issue Tracker](https://github.com/ai-trackdown/ai-trackdown-pytools/issues)
- 📧 Email: support@ai-trackdown.com
### Community
- [Discord Server](https://discord.gg/ai-trackdown)
- [Twitter/X](https://twitter.com/aitrackdown)
- [Blog](https://blog.ai-trackdown.com)
## License
AI Trackdown PyTools is open source software licensed under the [MIT License](LICENSE).
## Acknowledgments
- Inspired by the original [ai-trackdown-tools](https://github.com/ai-trackdown/ai-trackdown-tools)
- Built with [Typer](https://typer.tiangolo.com/) for an exceptional CLI experience
- Uses [Rich](https://rich.readthedocs.io/) for beautiful terminal output
- Powered by [Pydantic](https://pydantic-docs.helpmanual.io/) for robust data validation
- Special thanks to all [contributors](https://github.com/ai-trackdown/ai-trackdown-pytools/graphs/contributors)
## Links
- 🏠 [Homepage](https://ai-trackdown.com)
- 📦 [PyPI Package](https://pypi.org/project/ai-trackdown-pytools/)
- 🐙 [GitHub Repository](https://github.com/ai-trackdown/ai-trackdown-pytools)
- 📖 [Documentation](https://ai-trackdown-pytools.readthedocs.io/)
- 📋 [Changelog](CHANGELOG.md)
- 🗺️ [Roadmap](https://github.com/ai-trackdown/ai-trackdown-pytools/projects/1)
---
<p align="center">
Made with ❤️ by the AI Trackdown Team
</p>
Raw data
{
"_id": null,
"home_page": null,
"name": "ai-trackdown-pytools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "AI Trackdown Team <support@ai-trackdown.com>",
"keywords": "agile, ai, artificial-intelligence, cli, git, kanban, machine-learning, productivity, project-management, pydantic, rich, scrum, task-management, tasks, terminal, tracking, typer, workflow",
"author": null,
"author_email": "AI Trackdown Team <dev@ai-trackdown.com>",
"download_url": "https://files.pythonhosted.org/packages/5b/55/7cf309a1517634bf94939203a39783dee1636b89188200c48a434743335e/ai_trackdown_pytools-1.1.1.tar.gz",
"platform": null,
"description": "# AI Trackdown PyTools\n\n[](https://pypi.org/project/ai-trackdown-pytools/)\n[](https://pypi.org/project/ai-trackdown-pytools/)\n[](https://pypi.org/project/ai-trackdown-pytools/)\n[](https://github.com/ai-trackdown/ai-trackdown-pytools/actions)\n[](https://codecov.io/gh/ai-trackdown/ai-trackdown-pytools)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/psf/black)\n\n**Modern Python CLI tools for AI project tracking and task management**\n\nAI Trackdown PyTools brings powerful project management capabilities to your terminal, specifically designed for AI and software development workflows. With beautiful terminal output, intuitive commands, and seamless Git integration, it's the perfect companion for managing complex projects.\n\n## Why AI Trackdown PyTools?\n\n- **\ud83c\udfaf Purpose-Built for AI Projects**: Designed specifically for managing AI and ML project workflows\n- **\u26a1 Fast and Lightweight**: Minimal dependencies, instant startup, no bloat\n- **\ud83c\udfa8 Beautiful Terminal UI**: Rich formatting, colors, and interactive prompts that make CLI work enjoyable\n- **\ud83d\udd27 Extensible Architecture**: Plugin-ready design with customizable templates and workflows\n- **\ud83d\udd0d Smart Filtering**: Powerful search and filter capabilities across all your tasks and projects\n- **\ud83d\udcca Progress Tracking**: Visual progress indicators and comprehensive status reporting\n\n## Documentation\n\n- \ud83d\udcd6 **[User Documentation](docs/user/index.md)** - Installation, usage guides, and command reference\n- \ud83d\udd27 **[Development Documentation](docs/development/index.md)** - Contributing, testing, and release procedures\n\n## Key Features\n\n- \ud83d\ude80 **Modern CLI Experience** - Built with Typer and Rich for an exceptional terminal experience\n- \ud83d\udccb **Hierarchical Task Management** - Organize tasks, epics, issues, and PRs with parent-child relationships\n- \ud83c\udfd7\ufe0f **Smart Project Templates** - Pre-configured templates for common AI project structures\n- \ud83d\udcdd **Flexible Template System** - Create and share custom templates for any workflow\n- \ud83d\udd0d **Advanced Search** - Filter by status, assignee, tags, priority, and custom fields\n- \ud83c\udfaf **Schema Validation** - Ensure data integrity with JSON schema validation\n- \ud83d\udd27 **Deep Git Integration** - Automatic commit tracking, branch management, and PR linking\n- \ud83d\udd04 **GitHub Sync** - Sync tasks with GitHub issues and pull requests bidirectionally\n- \ud83c\udfa8 **Rich Terminal Output** - Tables, progress bars, syntax highlighting, and more\n- \ud83c\udf10 **Multi-Project Support** - Manage multiple projects from a single installation\n- \ud83d\udcc8 **Analytics and Reporting** - Built-in project analytics and customizable reports\n\n## Installation\n\n### Requirements\n\n- Python 3.8 or higher\n- Git (optional, for version control features)\n\n### Install from PyPI\n\n```bash\npip install ai-trackdown-pytools\n```\n\n### Install with pipx (Recommended for CLI tools)\n\n```bash\npipx install ai-trackdown-pytools\n```\n\n### Install from Source\n\n```bash\ngit clone https://github.com/ai-trackdown/ai-trackdown-pytools.git\ncd ai-trackdown-pytools\npip install -e .\n```\n\n### Development Installation\n\n```bash\ngit clone https://github.com/ai-trackdown/ai-trackdown-pytools.git\ncd ai-trackdown-pytools\npip install -e .[dev]\npre-commit install\n```\n\n### Verify Installation\n\n```bash\naitrackdown --version\naitrackdown --help\n```\n\n## Quick Start\n\n### 1. Initialize Your First Project\n\n```bash\n# Create a new directory for your project\nmkdir my-ai-project && cd my-ai-project\n\n# Initialize AI Trackdown with interactive setup\naitrackdown init project\n\n# Or use a pre-configured template\naitrackdown init project --template ml-research\n```\n\n### 2. Create Your First Task\n\n```bash\n# Interactive task creation\naitrackdown create task\n\n# Or create directly with options\naitrackdown create task \"Implement data preprocessing pipeline\" \\\n --priority high \\\n --assignee \"alice@team.com\" \\\n --tag \"data-pipeline\"\n```\n\n### 3. View Project Status\n\n```bash\n# See all tasks at a glance\naitrackdown status\n\n# Get detailed project overview\naitrackdown status project --detailed\n```\n\n## Core Commands\n\n### AI-Friendly Mode\n\nAI Trackdown PyTools supports a plain output mode optimized for AI tools and automated scripts:\n\n```bash\n# Use --plain flag for simplified output\naitrackdown --plain version\naitrackdown --plain info\naitrackdown --plain status\n\n# Or set environment variable\nexport AITRACKDOWN_PLAIN=1\naitrackdown version\n\n# Also respects NO_COLOR standard\nexport NO_COLOR=1\naitrackdown status\n```\n\nThe plain mode:\n- Removes all color codes and rich formatting\n- Simplifies output structure for easier parsing\n- Ideal for piping to other tools or AI systems\n- Automatically enabled in CI environments\n\n### Task Management\n\n```bash\n# Create a new task interactively\naitrackdown create task\n\n# Create task with full details\naitrackdown create task \"Implement authentication\" \\\n --description \"Add JWT authentication to API endpoints\" \\\n --assignee \"john@example.com\" \\\n --tag \"backend\" --tag \"security\" \\\n --priority \"high\" \\\n --due \"2025-08-15\"\n\n# Create from template\naitrackdown create task --template bug-report\n\n# Create subtask under parent\naitrackdown create task \"Write unit tests\" --parent TSK-0001\n```\n\n### View and Filter Tasks\n\n```bash\n# List all tasks with rich formatting\naitrackdown status tasks\n\n# Filter by multiple criteria\naitrackdown status tasks \\\n --status open \\\n --assignee \"john@example.com\" \\\n --tag \"backend\" \\\n --priority high\n\n# Search tasks by keyword\naitrackdown search \"authentication\" --type task\n\n# Show task details\naitrackdown show TSK-0001\n\n# Update task status\naitrackdown update TSK-0001 --status in-progress\n```\n\n### Template Management\n\n```bash\n# List all available templates\naitrackdown template list\n\n# Show template details\naitrackdown template show bug-report --type task\n\n# Create custom template interactively\naitrackdown template create\n\n# Create template from existing task\naitrackdown template create --from TSK-0001 --name \"feature-template\"\n\n# Share template\naitrackdown template export feature-template --output feature.yaml\naitrackdown template import feature.yaml\n```\n\n### GitHub Sync\n\n```bash\n# Check sync status\naitrackdown sync github status\n\n# Push local issues to GitHub (dry-run first)\naitrackdown sync github push --dry-run\naitrackdown sync github push\n\n# Pull GitHub issues to local tasks\naitrackdown sync github pull --dry-run\naitrackdown sync github pull\n\n# Specify repository explicitly\naitrackdown sync github push --repo owner/repo\n```\n\n## Complete Command Reference\n\n### Core Commands\n\n| Command | Description | Example |\n|---------|-------------|----------|\n| `init` | Initialize project or configuration | `aitrackdown init project` |\n| `create` | Create tasks, issues, epics, PRs | `aitrackdown create task \"New feature\"` |\n| `status` | Show project and task status | `aitrackdown status tasks --open` |\n| `update` | Update existing items | `aitrackdown update TSK-0001 --status done` |\n| `show` | Display detailed information | `aitrackdown show TSK-0001` |\n| `search` | Search across all items | `aitrackdown search \"bug\" --type issue` |\n| `template` | Manage templates | `aitrackdown template list` |\n\n### Advanced Commands\n\n| Command | Description | Example |\n|---------|-------------|----------|\n| `epic` | Manage epic tasks | `aitrackdown epic create \"Q3 Features\"` |\n| `pr` | Create and link pull requests | `aitrackdown pr create --branch feature/auth` |\n| `migrate` | Migrate from other tools | `aitrackdown migrate --from jira` |\n| `sync` | Sync with GitHub issues/PRs | `aitrackdown sync github push` |\n| `report` | Generate reports | `aitrackdown report weekly --format html` |\n\n### Utility Commands\n\n| Command | Description | Example |\n|---------|-------------|----------|\n| `info` | System information | `aitrackdown info` |\n| `health` | Health check | `aitrackdown health --verbose` |\n| `config` | Configuration management | `aitrackdown config set editor.default \"vim\"` |\n| `export` | Export data | `aitrackdown export --format json` |\n\n### Quick Aliases\n\n- `atd` \u2192 `aitrackdown`\n- `atd-init` \u2192 `aitrackdown init`\n- `atd-create` \u2192 `aitrackdown create`\n- `atd-status` \u2192 `aitrackdown status`\n\n## Project Structure\n\n```\nmy-project/\n\u251c\u2500\u2500 .ai-trackdown/ # Configuration and templates\n\u2502 \u251c\u2500\u2500 config.yaml # Project configuration\n\u2502 \u251c\u2500\u2500 project.yaml # Project metadata\n\u2502 \u251c\u2500\u2500 templates/ # Custom templates\n\u2502 \u2514\u2500\u2500 schemas/ # Custom schemas\n\u251c\u2500\u2500 tasks/ # Task files organized by type\n\u2502 \u251c\u2500\u2500 tsk/ # Standard tasks\n\u2502 \u251c\u2500\u2500 epic/ # Epic tasks\n\u2502 \u2514\u2500\u2500 bug/ # Bug reports\n\u251c\u2500\u2500 docs/ # Documentation\n\u2514\u2500\u2500 README.md # Project documentation\n```\n\n## Configuration\n\nAI Trackdown PyTools uses YAML configuration files:\n\n### Global Configuration (`~/.ai-trackdown/config.yaml`)\n\n```yaml\nversion: \"1.0.0\"\neditor:\n default: \"code\" # Default editor for task editing\ntemplates:\n directory: \"templates\"\ngit:\n auto_commit: false\n commit_prefix: \"[ai-trackdown]\"\n```\n\n### Project Configuration (`.ai-trackdown/config.yaml`)\n\n```yaml\nversion: \"1.0.0\"\nproject:\n name: \"My Project\"\n description: \"Project description\"\n version: \"1.0.0\"\ntasks:\n directory: \"tasks\"\n auto_id: true\n id_format: \"TSK-{counter:04d}\"\ntemplates:\n directory: \"templates\"\n```\n\n## Templates\n\nTemplates are powerful tools for standardizing task creation:\n\n### Task Template Example\n\n```yaml\nname: \"Bug Report Template\"\ndescription: \"Template for bug reports\"\ntype: \"task\"\nversion: \"1.0.0\"\n\nvariables:\n severity:\n description: \"Bug severity\"\n default: \"medium\"\n choices: [\"low\", \"medium\", \"high\", \"critical\"]\n component:\n description: \"Affected component\"\n required: true\n\ncontent: |\n # Bug: {{ title }}\n \n ## Description\n {{ description }}\n \n ## Severity\n {{ severity }}\n \n ## Affected Component\n {{ component }}\n \n ## Steps to Reproduce\n 1. \n 2. \n 3. \n \n ## Expected Behavior\n \n ## Actual Behavior\n \n ## Environment\n - OS: \n - Browser: \n - Version: \n```\n\n## Real-World Examples\n\n### Managing an ML Research Project\n\n```bash\n# Initialize ML research project\naitrackdown init project --template ml-research\n\n# Create research epic\naitrackdown create epic \"Experiment: Vision Transformer Fine-tuning\" \\\n --goal \"Achieve 95% accuracy on custom dataset\"\n\n# Create subtasks\naitrackdown create task \"Prepare dataset\" --parent EPIC-0001 --assignee \"data-team\"\naitrackdown create task \"Implement model architecture\" --parent EPIC-0001\naitrackdown create task \"Run baseline experiments\" --parent EPIC-0001\n\n# Track experiment results\naitrackdown update TSK-0003 --add-note \"Baseline accuracy: 87.3%\"\n```\n\n### Bug Tracking Workflow\n\n```bash\n# Report a bug\naitrackdown create issue \"Model inference crashes on GPU\" \\\n --type bug \\\n --severity critical \\\n --component \"inference-engine\" \\\n --affects-version \"2.1.0\"\n\n# Link to PR\naitrackdown create pr \"Fix GPU memory leak in inference\" \\\n --fixes BUG-0001 \\\n --branch hotfix/gpu-memory-leak\n```\n\n### Sprint Planning\n\n```bash\n# Create sprint epic\naitrackdown create epic \"Sprint 23: Authentication & API\" \\\n --start \"2025-08-01\" \\\n --end \"2025-08-14\"\n\n# Bulk assign tasks to sprint\naitrackdown update --tag \"sprint-23\" --bulk TSK-0001,TSK-0002,TSK-0003\n\n# View sprint progress\naitrackdown status sprint --id 23\n```\n\n### Git Integration\n\nSeamlessly integrate with your Git workflow:\n\n```bash\n# Initialize with Git integration\naitrackdown init project --git\n\n# Auto-link commits to tasks\ngit commit -m \"feat: Add user authentication\n\nImplements TSK-0001\nCo-authored-by: AI Trackdown <ai@trackdown.com>\"\n\n# Create PR with task linking\naitrackdown pr create \\\n --title \"Add authentication system\" \\\n --implements TSK-0001,TSK-0002 \\\n --reviewers \"alice,bob\"\n\n# Auto-close tasks on merge\naitrackdown config set git.auto_close_on_merge true\n```\n\n### Data Validation and Quality\n\n```bash\n# Validate all project data\naitrackdown validate\n\n# Validate specific template\naitrackdown template validate feature-template\n\n# Check project health\naitrackdown health --verbose\n\n# Audit project for issues\naitrackdown audit --fix\n```\n\n## Plugin System (Coming Soon)\n\n```python\n# Example custom plugin\nfrom ai_trackdown_pytools.plugins import Plugin\n\nclass JiraImporter(Plugin):\n \"\"\"Import tasks from Jira.\"\"\"\n \n def execute(self, context):\n # Implementation here\n pass\n\n# Register and use\naitrackdown plugin install jira-importer\naitrackdown import --from jira --project \"PROJ\"\n```\n\n## Contributing\n\nWe love contributions! AI Trackdown PyTools is a community-driven project, and we welcome contributions of all kinds.\n\n### Ways to Contribute\n\n- \ud83d\udc1b **Report bugs** and suggest features\n- \ud83d\udcd6 **Improve documentation** and examples \n- \ud83e\uddea **Write tests** and improve coverage\n- \ud83c\udfa8 **Create templates** for common workflows\n- \ud83d\udcbb **Submit pull requests** with enhancements\n\nSee our [Contributing Guide](CONTRIBUTING.md) for detailed instructions.\n\n### Quick Development Setup\n\n```bash\n# Clone and setup\ngit clone https://github.com/ai-trackdown/ai-trackdown-pytools.git\ncd ai-trackdown-pytools\npip install -e .[dev]\npre-commit install\n\n# Run tests\npytest\n\n# Format code\nblack src tests\nruff check src tests --fix\n```\n\n## Support\n\n### Getting Help\n\n- \ud83d\udcda [Documentation](https://ai-trackdown-pytools.readthedocs.io/)\n- \ud83d\udcac [Discussions](https://github.com/ai-trackdown/ai-trackdown-pytools/discussions)\n- \ud83d\udc1b [Issue Tracker](https://github.com/ai-trackdown/ai-trackdown-pytools/issues)\n- \ud83d\udce7 Email: support@ai-trackdown.com\n\n### Community\n\n- [Discord Server](https://discord.gg/ai-trackdown)\n- [Twitter/X](https://twitter.com/aitrackdown)\n- [Blog](https://blog.ai-trackdown.com)\n\n## License\n\nAI Trackdown PyTools is open source software licensed under the [MIT License](LICENSE).\n\n## Acknowledgments\n\n- Inspired by the original [ai-trackdown-tools](https://github.com/ai-trackdown/ai-trackdown-tools)\n- Built with [Typer](https://typer.tiangolo.com/) for an exceptional CLI experience\n- Uses [Rich](https://rich.readthedocs.io/) for beautiful terminal output\n- Powered by [Pydantic](https://pydantic-docs.helpmanual.io/) for robust data validation\n- Special thanks to all [contributors](https://github.com/ai-trackdown/ai-trackdown-pytools/graphs/contributors)\n\n## Links\n\n- \ud83c\udfe0 [Homepage](https://ai-trackdown.com)\n- \ud83d\udce6 [PyPI Package](https://pypi.org/project/ai-trackdown-pytools/)\n- \ud83d\udc19 [GitHub Repository](https://github.com/ai-trackdown/ai-trackdown-pytools)\n- \ud83d\udcd6 [Documentation](https://ai-trackdown-pytools.readthedocs.io/)\n- \ud83d\udccb [Changelog](CHANGELOG.md)\n- \ud83d\uddfa\ufe0f [Roadmap](https://github.com/ai-trackdown/ai-trackdown-pytools/projects/1)\n\n---\n\n<p align=\"center\">\n Made with \u2764\ufe0f by the AI Trackdown Team\n</p>",
"bugtrack_url": null,
"license": "MIT",
"summary": "Modern Python CLI tools for AI project tracking and task management",
"version": "1.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/ai-trackdown/ai-trackdown-pytools/issues",
"Changelog": "https://github.com/ai-trackdown/ai-trackdown-pytools/blob/main/CHANGELOG.md",
"Discord": "https://discord.gg/ai-trackdown",
"Documentation": "https://ai-trackdown-pytools.readthedocs.io/",
"Funding": "https://github.com/sponsors/ai-trackdown",
"Homepage": "https://ai-trackdown.com",
"Repository": "https://github.com/ai-trackdown/ai-trackdown-pytools.git",
"Source Code": "https://github.com/ai-trackdown/ai-trackdown-pytools",
"Twitter": "https://twitter.com/aitrackdown"
},
"split_keywords": [
"agile",
" ai",
" artificial-intelligence",
" cli",
" git",
" kanban",
" machine-learning",
" productivity",
" project-management",
" pydantic",
" rich",
" scrum",
" task-management",
" tasks",
" terminal",
" tracking",
" typer",
" workflow"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c92a84cda03b4b70eaad850c0bcf01f5240483c572b54bde6f80c3304e948867",
"md5": "b42ae2197d2ebe065023d4ff84684cef",
"sha256": "e04abaaae0999423e019cb0f9f66938c77e96c622c8929e28ae7c07a27cc992c"
},
"downloads": -1,
"filename": "ai_trackdown_pytools-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b42ae2197d2ebe065023d4ff84684cef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 131155,
"upload_time": "2025-07-23T12:50:07",
"upload_time_iso_8601": "2025-07-23T12:50:07.247523Z",
"url": "https://files.pythonhosted.org/packages/c9/2a/84cda03b4b70eaad850c0bcf01f5240483c572b54bde6f80c3304e948867/ai_trackdown_pytools-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5b557cf309a1517634bf94939203a39783dee1636b89188200c48a434743335e",
"md5": "abdc326b9e92a48ccc773453552aa2ea",
"sha256": "74fffc711f59aef47e887cb4faf91c2a1f184a5ba12f3d1ae66611af951b5f7b"
},
"downloads": -1,
"filename": "ai_trackdown_pytools-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "abdc326b9e92a48ccc773453552aa2ea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 289632,
"upload_time": "2025-07-23T12:50:09",
"upload_time_iso_8601": "2025-07-23T12:50:09.228618Z",
"url": "https://files.pythonhosted.org/packages/5b/55/7cf309a1517634bf94939203a39783dee1636b89188200c48a434743335e/ai_trackdown_pytools-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-23 12:50:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ai-trackdown",
"github_project": "ai-trackdown-pytools",
"github_not_found": true,
"lcname": "ai-trackdown-pytools"
}
JSON
