Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

amodal dev

Start a local runtime server for development. The server watches your repo config files and hot-reloads on every change.

amodal dev

Options

FlagDefaultDescription
--port3847Server port
--hostlocalhostServer host

What It Does

  1. Loads your repo configuration from the project root
  2. Starts an Express server with SSE streaming
  3. Watches all config files with 300ms debounce
  4. Manages sessions with TTL-based cleanup

Endpoints

The dev server exposes:

MethodPathDescription
POST/chatSend a message, receive SSE stream
POST/taskStart a background task
GET/task/:idGet task status
GET/task/:id/streamStream task output
GET/inspect/contextView compiled context with token counts
GET/healthHealth check

SSE Events

The chat endpoint returns a Server-Sent Events stream with these event types:

EventDescription
textAssistant text output
tool_callTool invocation
ExploreStart / ExploreEndSystem exploration phase
PlanModePlanning phase
skill_activatedSkill activation
FieldScrubSensitive field redaction
ConfirmationRequiredWrite operation needs approval
kb_proposalKnowledge base update proposal

Hot Reload

Edit any config file and the runtime picks up changes immediately:

  • Connection specs, skills, knowledge, tools, automations
  • Config changes (provider, model, etc.)
  • No server restart needed