AnyTask CLI v0.6 - Filesystem-First Task Sync

Local task sync with pull/push workflow, enabling any AI tool to work with tasks. Code quality improvements with modular architecture and domain-specific exceptions.

AnyTask CLI v0.6 introduces filesystem-first task synchronization, enabling seamless integration with any AI coding tool.

Highlights

Filesystem-First Task Sync

New local task management commands that enable any AI tool to work with AnyTask:

  • anyt pull <ID> - Download task from server to local .anyt/tasks/{ID}/ folder
  • anyt push <ID> - Upload local task changes back to server
  • anyt open <ID> - Open task folder in file manager (Finder/Explorer)

Local Task Folder Structure:

.anyt/tasks/{ID}/
├── task.md           # Task description
├── .meta.json        # Metadata
└── context/          # AI context files

This enables Claude Code, Cursor, Gemini CLI, and any other AI tool to work with tasks simply by reading local files.

Remote Repository Workflow

Enhanced remote_repo workflow now default for worker system:

  • Automatic task branch detection in workflows
  • User repository checkout support for workers
  • Local task worker actions for filesystem-first integration

Code Quality Improvements

Major internal refactoring for maintainability:

  • Type Guards: Replaced runtime asserts with type guard functions
  • Edit Helpers: Extracted shared edit helpers from task update commands
  • Board Module: Split board/commands.py into renderers and formatters modules
  • ServiceRegistry Pattern: Migrated .from_config() to ServiceRegistry pattern
  • Exception Hierarchy: Created domain-specific exception hierarchy
  • Worker Package: Modularized worker.py into package structure
  • Specific Exceptions: Replaced bare except blocks with specific exception types

Changes

  • Default Workflow: Changed from local_dev to remote_repo
  • System Worker: Command is now hidden from help output (internal use only)
  • Worker System: Enhanced error handling and stream buffer limit fixes

Version History

  • v0.6.0 - November 26, 2025: Filesystem-first task sync, code quality improvements

Learn more at PyPI.