amodal dev
Start a local runtime server for development. The server watches your repo config files and hot-reloads on every change.
amodal devOptions
| Flag | Default | Description |
|---|---|---|
--port | 3847 | Server port |
--host | localhost | Server host |
--resume | Resume a previous session by ID or latest | |
-v | Increase log verbosity (-v for debug, -vv for trace) | |
-q / --quiet | Only show errors |
Log Levels
The default log level is info — startup messages, connection status, and warnings. Use -v or -vv to see more, or -q to see less.
| Flag | Level | What you see |
|---|---|---|
-q | error | Errors and fatal only |
| (default) | info | Startup, connections, warnings |
-v | debug | Session init, MCP, store ops, config reload |
-vv | trace | Tool execution, upstream library output |
You can also set the LOG_LEVEL environment variable (trace, debug, info, warn, error, fatal, none). The env var takes precedence over CLI flags.
# Quiet mode
amodal dev -q
# Debug output
amodal dev -v
# Full trace (including upstream library noise)
amodal dev -vv
# Via environment variable
LOG_LEVEL=debug amodal devWhat It Does
- Loads your repo configuration from the project root
- Starts an Express server with SSE streaming
- Watches all config files with 300ms debounce
- Manages sessions with TTL-based cleanup
Endpoints
The dev server exposes:
| Method | Path | Description |
|---|---|---|
POST | /chat | Send a message, receive SSE stream |
POST | /task | Start a background task |
GET | /task/:id | Get task status |
GET | /task/:id/stream | Stream task output |
GET | /inspect/context | View compiled context with token counts |
GET | /health | Health check |
SSE Events
The chat endpoint returns a Server-Sent Events stream with these event types:
| Event | Description |
|---|---|
text | Assistant text output |
tool_call | Tool invocation |
ExploreStart / ExploreEnd | System exploration phase |
PlanMode | Planning phase |
skill_activated | Skill activation |
FieldScrub | Sensitive field redaction |
ConfirmationRequired | Write operation needs approval |
kb_proposal | Knowledge 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