Metadata-Version: 2.4
Name: taskfloor-agent
Version: 0.2.0
Summary: Local agent for TaskFloor — connects Claude Code to your task board
License-Expression: MIT
Project-URL: Homepage, https://taskfloor.xyz
Project-URL: Repository, https://github.com/cheetah-trade/backlog-service/tree/main/agent
Project-URL: Issues, https://github.com/cheetah-trade/backlog-service/issues
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: websockets>=12.0
Requires-Dist: click>=8.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: httpx>=0.27
Requires-Dist: claude-agent-sdk>=0.1.0
Dynamic: license-file

# taskfloor-agent

Local agent that connects [Claude Code](https://claude.ai/code) to your [TaskFloor](https://taskfloor.xyz) task board. It runs as a background daemon, auto-discovers your projects by matching git remotes, and executes tasks in isolated git worktrees with real-time streaming to the browser.

## Installation

```bash
# Recommended (isolated environment)
pipx install taskfloor-agent

# Or with pip
pip install taskfloor-agent
```

Requires Python 3.10+.

## Quick Start

1. **Login** — configure your server URL and agent token (get the token from TaskFloor Settings):

   ```bash
   taskfloor-agent login
   ```

2. **Start** — run the agent in the background:

   ```bash
   taskfloor-agent start
   ```

3. **Check status** — verify the agent is connected:

   ```bash
   taskfloor-agent status
   ```

## Commands

| Command | Description |
|---------|-------------|
| `taskfloor-agent login` | Configure server URL, token, and scan directories |
| `taskfloor-agent start` | Start agent daemon (use `--foreground` for dev) |
| `taskfloor-agent stop` | Stop background daemon |
| `taskfloor-agent status` | Show config, connection, and discovered projects |
| `taskfloor-agent logs` | View agent logs (`-f` to follow) |
| `taskfloor-agent add <path>` | Add a local project directory |
| `taskfloor-agent cleanup` | Remove TaskFloor worktrees from local repos |

## How It Works

The agent connects to your TaskFloor server via WebSocket, receives task assignments, and runs Claude Code sessions in isolated git worktrees. Each task gets its own branch (`taskfloor/task-{id}`) and worktree (`.worktrees/task-{id}`), so work is isolated from your main branch.

Project discovery is automatic — the agent scans your configured directories for git repos and matches their remotes against TaskFloor projects.

## Configuration

Config file: `~/.taskfloor/agent.yaml`

```yaml
server: https://taskfloor.xyz
token: <your-agent-token>
agent_id: username-hostname
scan_dirs:
  - ~/Projects
project_paths:
  - ~/Projects/my-specific-repo
```

## Links

- [TaskFloor](https://taskfloor.xyz) — task management platform
- [Repository](https://github.com/cheetah-trade/backlog-service/tree/main/agent)
- [Issues](https://github.com/cheetah-trade/backlog-service/issues)
