Skip to content
Hoody Documentation
Download Page (.md)

Hoody Agent

Section titled “Hoody Agent”

The Hoody Agent service is the core runtime that powers AI-assisted development inside workspaces. It manages agent sessions, multi-phase task orchestration, git workflows, persistent memory, file access, MCP server connections, skill discovery, permission handling, and provider configuration. Every long-running agent interaction — from a single prompt to a multi-step orchestrated plan — flows through this service.

Use the endpoints on this page to verify service health, and follow the sub-page links below for the full surface area of each subsystem.

Sub-services

Section titled “Sub-services”

Sessions

Create, prompt, fork, revert, abort, and inspect agent sessions.

→ Sessions API

Orchestration

Multi-phase task execution, todo management, executor control, and orchestrator sessions.

→ Orchestration API

Branches

Git branch management for agent workspaces, including PRs and merges.

→ Branches API

Memory

Persistent memory blocks, journal entries, and history events.

→ Memory API

Meta

Workspace metadata, agents, skills discovery, paths, VCS, LSP, and event subscriptions.

→ Meta API

Files

File listing, search, symbol search, and content reads scoped to a workspace.

→ Files API

MCP

Model Context Protocol server connections and OAuth flows.

→ MCP API

Providers

LLM provider listing, auth methods, and OAuth callbacks.

→ Providers API

Config

Agent configuration get/update and tool overrides.

→ Config API

Health

Section titled “Health”

GET /api/v1/workspaces/health

Section titled “GET /api/v1/workspaces/health”

Returns the standardized 9-field health response for the workspaces service. This endpoint is unauthenticated and is suitable for readiness and liveness probes.

This endpoint takes no parameters.

Terminal window
curl -X GET https://api.hoody.com/api/v1/workspaces/health