Metadata-Version: 2.4
Name: anyt
Version: 0.2.0
Summary: AI-native task management CLI for coding agents and human developers
Project-URL: Homepage, https://anyt.dev
Project-URL: Documentation, https://anyt.dev/docs/cli
Project-URL: Support, https://anyt.dev/support
Author-email: AnyTransformer Inc <contact@anytransformer.com>
Maintainer-email: AnyTransformer Inc <contact@anytransformer.com>
License: Proprietary
License-File: LICENSE
Keywords: ai,cli,developer-tools,productivity,task-management
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Requires-Dist: httpx>=0.28.1
Requires-Dist: keyring>=25.0.0
Requires-Dist: langchain-anthropic>=0.3.21
Requires-Dist: langchain-openai>=0.3.34
Requires-Dist: langgraph>=0.6.8
Requires-Dist: mcp>=1.17.0
Requires-Dist: pydantic>=2.11.9
Requires-Dist: pyperclip>=1.8.2
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=14.0.0
Requires-Dist: tenacity>=9.1.2
Requires-Dist: typer>=0.15.3
Description-Content-Type: text/markdown

# AnyTask CLI

> AI-native task management CLI for coding agents and human developers

AnyTask CLI is a command-line interface for managing tasks and projects, designed specifically for AI agents and developers working together. It provides Linear-style task management with agent-aware features, MCP (Model Context Protocol) integration, and powerful AI-assisted commands.

## Features

- **Linear-style Task Management**: Human-readable task IDs (DEV-123), status workflows, priorities, and dependencies
- **Multi-Environment Support**: Manage tasks across dev, staging, and production environments
- **Workspace & Project Organization**: Isolated workspaces with role-based access
- **Rich Terminal UI**: Beautiful, color-coded task boards and visualizations
- **Agent Integration**: Native support for AI agents via API keys and MCP server
- **Worker System**: Automated task execution using declarative YAML workflows
- **AI-Powered Commands**: Task decomposition, smart suggestions, and context-aware assistance

## Installation

### Recommended: Install with uvx or pipx

For the best experience, install using `uvx` (recommended) or `pipx`:

```bash
# Using uvx (recommended - no installation needed)
uvx anyt --help

# Or using pipx (install once, use everywhere)
pipx install anyt
anyt --help
```

### Alternative: Install with pip

```bash
pip install anyt
```


## Quick Start

### 1. Configure Environment

The CLI comes pre-configured with a production environment. To use a local development server:

```bash
anyt env add dev http://localhost:8000
anyt env use dev
```

View your environments:

```bash
anyt env list
```

### 2. Authenticate

**For human users:**

```bash
anyt auth login
# Paste your JWT token when prompted
```

**For AI agents:**

```bash
anyt auth login --agent-key anyt_agent_xxxxxxxxxxxxx
```

### 3. Select Workspace

```bash
anyt workspace list
anyt workspace select DEV
```

### 4. Create Your First Task

```bash
anyt task create "Implement user authentication" --status todo --priority 1
```

## Core Commands

### Environment Management

```bash
anyt env add <name> <api-url>    # Add new environment
anyt env list                     # List all environments
anyt env use <name>               # Switch environment
anyt env remove <name>            # Remove environment
```

### Authentication

```bash
anyt auth login                   # Login with user token
anyt auth login --agent-key KEY   # Login with agent API key
anyt auth whoami                  # Show current user info
anyt auth logout                  # Logout
```

### Workspace Management

```bash
anyt workspace list               # List workspaces
anyt workspace select <identifier> # Select workspace
anyt workspace create <name>      # Create new workspace
```

### Task Management

**Create and update tasks:**

```bash
anyt task create <title>          # Create new task
  --status <todo|inprogress|done>
  --priority <1-5>
  --assignee <user-id>
  --project-id <id>

anyt task update <identifier>     # Update task
  --status <status>
  --priority <priority>
  --title <new-title>

anyt task delete <identifier>     # Delete task
```

**View tasks:**

```bash
anyt task list                    # List all tasks
  --status <status>               # Filter by status
  --priority <priority>           # Filter by priority
  --assignee <user-id>            # Filter by assignee

anyt task get <identifier>        # Get task details
anyt task board                   # View Kanban board
```

**Task dependencies:**

```bash
anyt task dep add <task> --blocks <other-task>
anyt task dep remove <task> --blocks <other-task>
anyt task dep list <task>
```

**Active task tracking:**

```bash
anyt task pick <identifier>       # Pick task to work on
anyt task active                  # Show current task
anyt task drop                    # Drop current task
```

### AI-Powered Commands

```bash
anyt ai decompose <goal>          # Decompose goal into tasks
  --project-id <id>

anyt ai suggest                   # Get task suggestions
  --limit <number>
```

### Worker System

Automated task execution using YAML workflows:

```bash
anyt worker start                 # Start worker daemon
anyt worker stop                  # Stop worker
anyt worker status                # Check worker status
```

Create a workflow file in `.anyt/workflows/`:

```yaml
name: Feature Development
on:
  task_created:
    labels: ["feature"]
jobs:
  develop:
    steps:
      - uses: anyt/checkout@v1
      - uses: anyt/claude-code@v1
        with:
          prompt: "Implement: ${{ task.description }}"
      - run: make test
      - uses: anyt/git-commit@v1
      - uses: anyt/task-update@v1
        with:
          status: done
```

## Usage Examples

### Daily Workflow

```bash
# View your board
anyt task board

# Pick a task
anyt task pick DEV-42

# Update progress
anyt task update DEV-42 --status inprogress

# Complete the task
anyt task update DEV-42 --status done
anyt task drop
```

### Team Collaboration

```bash
# List all tasks
anyt task list

# Filter by status
anyt task list --status inprogress

# View task details
anyt task get DEV-123

# Add dependencies
anyt task dep add DEV-124 --blocks DEV-123
```

### AI-Assisted Development

```bash
# Get task recommendations
anyt ai suggest --limit 5

# Decompose a complex goal
anyt ai decompose "Build authentication system" --project-id 1
```

## Claude Code Integration

AnyTask provides seamless integration with Claude Code through slash commands.

### Quick Setup

1. Install and configure AnyTask CLI
2. Use slash commands in Claude Code:
   - `/anyt-next` - Get intelligent task recommendations
   - `/anyt-active` - View your current task
   - `/anyt-create` - Create new tasks interactively
   - `/anyt-board` - See your Kanban board

### Example

```
User: /anyt-next

Claude: "📋 Top Task Recommendations:

1. DEV-42: Implement OAuth callback (Score: 15.0)
   • Priority: 2 (Urgent)
   • All dependencies complete ✓
   • Unblocks 2 other tasks

Which task would you like to work on?"
```

See [Claude Code Integration Guide](docs/CLAUDE_CODE_INTEGRATION.md) for details.

## Configuration

### Environment Configuration

Configuration is stored in `~/.config/anyt/config.json`:

```json
{
  "environments": {
    "prod": {
      "api_url": "http://api.anyt.dev",
      "auth_token": "your-token-here"
    }
  },
  "current_environment": "prod"
}
```

### Workspace Configuration

Workspace settings in `.anyt/anyt.json`:

```json
{
  "workspace_id": "1",
  "name": "Development",
  "api_url": "http://api.anyt.dev",
}
```

## Documentation

### User Guides

- [CLI Usage Guide](docs/CLI_USAGE.md) - Complete command reference
- [CLI Complete Reference](docs/CLI_COMPLETE_REFERENCE.md) - Generated documentation
- [Worker Quick Start](docs/WORKER_QUICK_START.md) - Automated task execution
- [Claude Code Integration](docs/CLAUDE_CODE_INTEGRATION.md) - AI-assisted development

### Developer Documentation

For internal development, see [DEVELOPER_GUIDE.md](DEVELOPER_GUIDE.md).

## Environment Variables

Optional configuration via environment variables:

- `ANYT_ENV` - Current environment (dev/staging/prod)
- `ANYT_AUTH_TOKEN` - Authentication token
- `ANYT_AGENT_KEY` - Agent API key
- `ANYT_CONFIG_DIR` - Override config directory (default: ~/.config/anyt)

## Support

For issues and questions, contact: contact@anytransformer.com

## License

Proprietary - AnyTransformer Inc.
