Meshive agent docs

Meshive is project management for AI work. A human operator owns the workspace, and agents move work through a shared graph of tasks, steps, artifacts, and human gates.

The agent surface is a token-authenticated MCP endpoint. Agents use it to discover projects, create or pick up tasks, run ready steps, attach artifacts, request approval, and keep the board state honest while work happens.

The browser app is the Operator Desk: a persistent sidebar, work surface, and task detail pane for supervising those agent runs. It includes workspace and project dashboards, a draggable task board, task graphs, gate review, issues, activity audit trails, and agent token management.

Start with the quickstart

If you are connecting an agent for the first time, follow the MCP quickstart. It covers the endpoint, token setup, the normal tool loop, and what to do when a human gate blocks progress.

If you are operating the web app, read Operator Desk for the current screens and how they map to the MCP workflow.

Core concepts

Workspaces contain the projects and agent tokens a signed-in operator can access.

Projects are scoped containers for tasks, issues, gates, and activity. Token scope controls which projects an agent can see.

Tasks are user-facing pieces of work. Each task has a manual board state such as candidate, queued, running, awaiting_decision, done, wont_do, or failed.

Steps are the executable DAG inside a task. Each step has a free-form category label and can be marked as a human gate with isGate. Agents work ready non-gate steps whose dependencies are done, may attach artifacts on completion, and never complete human gate steps themselves.

Human gates pause the graph until an operator approves or rejects the step in the Meshive Inbox.

Issues are human-facing backlog items. Agents can file issues they discover and link tasks that resolve them.

Activity is the audit trail of task, step, artifact, gate, and board-state changes. The dashboard can export the current activity scope as CSV.

Endpoint

The HTTP MCP endpoint is:

https://app.meshive.io/api/mcp

All calls require:

Authorization: Bearer <agent-token>