Documentation
Find the page that answers your question. Each page answers one. Start with your role, or scan the task list below.
> Find the page that answers your question. Each page answers one. Start with your role, or scan the task list below.
Agent Taskbay is pre-1.0. If a word is unfamiliar, the glossary defines it and links to the page that explains it.
Start here
- Can I make it work? Quickstart: run the console, connect a sample agent, approve an action.
- Is it ready for what I need? Status and roadmap and Compatibility and limitations.
- How does it work? Overview.
By role
| You are | Read, in order |
|---|---|
| Evaluating whether to use it | Overview, Quickstart, Status and roadmap, Compatibility, Threat model |
| Using the console day to day | Use the console, Approvals and ownership, Notifications |
| Running it for a team | Production deployment, Configuration recipes, Sign in and roles, Teams and grants, Agent credentials, Running and workers, Upgrading and backups |
| Building or connecting an agent | Connect an agent, Build an agent for Taskbay, Extensions, Receive push callbacks, A2UI subset |
Guides
How do I...
- ...use each screen (Agents, Chat, Tasks, Flows, Audit, Settings)? Use the console
- ...connect an A2A agent from its Agent Card? Connect an agent
- ...connect an agent that needs authentication (bearer token, API key, OAuth client credentials, mTLS), pin card signing keys, or restrict outbound origins? Agent credentials and outbound policy
- ...let agents push task updates to Taskbay instead of waiting for polling? Receive push callbacks from agents
- ...build an agent that asks for forms or approvals? Build an agent for Taskbay
- ...review approvals, own tasks and escalate overdue work? Approvals and ownership
- ...get notified, in the app or by a signed webhook? Notifications and webhooks
- ...set up OIDC sign-in and provision people? Sign in and roles
- ...give a team access to one agent or one skill? Teams and grants
- ...pick the right environment variables for my setup? Configuration recipes
- ...deploy with PostgreSQL and separate workers? Production deployment
- ...upgrade, back up and restore? Upgrading and backups
- ...try the experimental AG-UI adapter? Try the AG-UI adapter
Concepts
How it works, and why.
- Overview: what Taskbay is and is not
- Durable tasks: commands, workers, streams, push, polling, rebuilds
- Identity and access: people, agent credentials, roles, grants
- Human in the loop: inbox, approvals, ownership, audit, notifications
- Rich content: rendering, forms, A2UI, AG-UI
- Design decisions: decisions, trade-offs, links to the archived records
Reference
What exactly is supported?
- Configuration: every
A2A_*environment variable, default and error - CLI and scripts:
agent-taskbaycommands andnpm runscripts - HTTP API: routes, roles, request and error shapes
- Extensions: index, structured form, approval request, skill routing
- AG-UI adapter, A2UI subset
- Data model
- Compatibility and limitations
- Glossary
Operations
What happens when it fails?
- Running and workers
- Troubleshooting: look up an error message
Security
Project and contributing
Created and maintained by Shashi Kanth G S at allsrc.dev. Visit shashikanth.me.