Metadata-Version: 2.4
Name: workerlane
Version: 0.1.0
Summary: Harness-agnostic agent coworkers — agents, approvals, memory, traces, handoffs in one package for any agent harness
Project-URL: Homepage, https://github.com/talocode/workerlane
Project-URL: Documentation, https://docs.talocode.site
Project-URL: Source, https://github.com/talocode/workerlane
Author: Talocode
License-Expression: MIT
Keywords: agents,approvals,coworkers,handoff,mcp,memory,talocode,trace
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# WorkerLane

**Harness-agnostic agent coworkers for any agent runtime.** One package that wires team agents, approvals, memory, traces, and handoff contracts into whatever harness you already use.

[![PyPI](https://img.shields.io/pypi/v/workerlane)](https://pypi.org/project/workerlane/)
[![npm](https://img.shields.io/npm/v/@talocode/workerlane)](https://www.npmjs.com/package/@talocode/workerlane)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Part of **[Talocode](https://talocode.site)** — open tools people trust, hosted power behind them.

---

## What it is

AI agents are great at running tasks. The hard part is everything around them: who can run what, what gets approved, what happened last session, and proving it after the fact. WorkerLane bundles those pieces into one package that works with **any agent harness** — no runtime brand loyalty, no side to pick.

- **AI coworkers** — create agents with a name and role, queue tasks, gate destructive work behind approvals
- **Agent-human handoffs** — validate and repair step-to-step payloads against schema contracts so runs never silently drift
- **Full data recording, owned by you** — trace spans with cost and status, plus durable memory that persists across sessions. Everything is stored locally in `~/.workerlane` unless you opt into the hosted path
- **Computer use** — pair with `@talocode/screenlane` (`screenlane mcp`) to add screen capture, dictate, and command tools to the same harness
- **Works with any harness** — expose the whole bundle as MCP tools and connect any MCP-compatible agent

## Why it exists

The catalog is strong but fragmented — agents, traces, memory, handoffs each ship separately. WorkerLane removes the assembly. One install, one surface, all the pieces wired together. It is positioned as a capability layer above the harness, exactly where compounding value lives.

## Install

```bash
pip install workerlane
```

or

```bash
npm install -g @talocode/workerlane
```

No runtime, no cloud required for the local engine. The Python SDK uses a globally installed `workerlane` engine when available, otherwise it runs the public npm package through `npx`. State lives in `~/.workerlane/` (override with `WORKERLANE_DIR`).

## Quickstart (Python SDK)

```python
from workerlane import WorkerLaneClient

lane = WorkerLaneClient()

# create a coworker
agent = lane.create_agent(name="qa-bot", role="reviews every PR before merge")

# queue a task, gated behind a human approval
run = lane.run_agent(agent["id"], task="audit the auth flow", require_approval=True)
# run["status"] == "pending-approval"

# a human approves it — the decision is recorded
approved = lane.approve_run(run["id"], True)

# hosted path (needs TALOCODE_API_KEY)
hosted = lane.hosted()
hosted.agent_run(agent["id"], task="audit the auth flow")
```

## Auth / env

- `TALOCODE_API_KEY` — set to use the hosted `/v1/workerlane/*` path (Stacklane billing)
- `TALOCODE_BASE_URL` — defaults to `https://api.talocode.site`
- `WORKERLANE_DIR` — where local state is stored (defaults to `~/.workerlane`)

## API surface

The Python SDK mirrors the CLI and the hosted API:

| Action | Local | Hosted credits |
|--------|-------|----------------|
| `create_agent` / `list_agents` | ✅ | 0 |
| `run_agent` (with approval gate) | ✅ | 3 |
| `approve_run` | ✅ | 1 |
| `handoff_validate` / `handoff.repair` | via CLI | 2 / 4 |
| `memory_recall` / `memory.remember` | via CLI | 2 / 4 |
| `trace_start` / span / complete | via CLI | 1 / 1 / 2 |

Full MCP surface (`workerlane mcp`) exposes 16 tools: `workerlane_agent_create/list/run/approve/complete/runs`, `workerlane_handoff_validate/repair`, `workerlane_trace_start/span/span_end/complete/list`, `workerlane_memory_remember/recall/list`.

## CLI (npm engine)

```bash
workerlane agent create --name "qa-bot" --role "reviews every PR"
workerlane agent run --agent <ID> --task "audit" --approve
workerlane agent approve --run <RUN_ID> --yes
workerlane mcp          # start the MCP server for any harness
workerlane pricing
workerlane capabilities
```

## Related packages

- `@talocode/workerlane` (npm engine) · `pip install workerlane` (this package)
- `@talocode/screenlane` · `pip install talocode-screenlane`
- `@talocode/worklane` · `pip install talocode-worklane`
- `@talocode/memorylane` · `pip install talocode-memorylane`
- `@talocode/handofflane`
- `@talocode/tracelane`

## Talocode ecosystem

| Product | Repo |
|---------|------|
| **WorkerLane** (this package) | [github.com/talocode/workerlane](https://github.com/talocode/workerlane) |
| [Tera](https://github.com/talocode/tera) | Reasoning, writing, coding |
| [WorkLane](https://github.com/talocode/worklane) | Work automation |
| [MemoryLane](https://github.com/talocode/memorylane) | Persistent agent memory |
| [HandoffLane](https://github.com/talocode/handofflane) | Step-to-step schema contracts |
| [TraceLane](https://github.com/talocode/tracelane) | Run tracing + receipts |
| [PolicyLane](https://github.com/talocode/policylane) | Policy gates |
| [GateLane](https://github.com/talocode/gatelane) | Gate enforcement |
| [Agent Browser](https://github.com/talocode/agent-browser) | Browser automation for agents |
| [ScreenLane](https://github.com/talocode/screenlane) | Screen automation |
| [SearchLane](https://github.com/talocode/searchlane) | Search capability |
| [XSearchLane](https://github.com/talocode/xsearchlane) | X search |
| [DocuLane](https://github.com/talocode/doculane) | Office documents for agents |
| [DataLane](https://github.com/talocode/datalane) | Data analysis |
| [ClipLoop](https://github.com/talocode/cliploop) | Video creation |
| [Tradia](https://github.com/talocode/tradia) | Trading |
| [Codra](https://github.com/talocode/codra) | Coding agent |
| [StackLane](https://github.com/talocode/stacklane) | Cloud control plane |

More: [github.com/talocode](https://github.com/talocode) · [talocode.site](https://talocode.site) · [docs.talocode.site](https://docs.talocode.site)

## License

MIT © Talocode
