Quick Start

uv tool install terminaluse

tu login

tu init

from typing import Any

from terminaluse.lib import AgentServer, TaskContext
from terminaluse.types import Event, TextPart

server = AgentServer()


@server.on_create
async def handle_create(ctx: TaskContext, params: dict[str, Any]):
    await ctx.state.create({"turns": 0})
    await ctx.messages.send("Task created. Send me a message and I will write it to /workspace/output.txt.")


@server.on_event
async def handle_event(ctx: TaskContext, event: Event):
    if not isinstance(event.content, TextPart):
        await ctx.messages.send("Only text events are supported in this quickstart.")
        return

    state = await ctx.state.get() or {"turns": 0}
    turns = int(state.get("turns", 0)) + 1
    await ctx.state.update({"turns": turns})

    with open("/workspace/output.txt", "a") as f:
        f.write(f"turn {turns}: {event.content.text}\n")

    await ctx.messages.send(f"Wrote turn {turns} to /workspace/output.txt")


@server.on_cancel
async def handle_cancel(ctx: TaskContext):
    await ctx.messages.send("Task cancelled.")

tu deploy -y

tu projects create --namespace <your-namespace> --name quickstart

tu tasks create \
  -a <your-namespace>/<your-agent> \
  -p <project-id> \
  -m "hello from the quickstart"

tu tasks send <task-id> -m "write one more line"

tu tasks pull <task-id> --out ./quickstart-output