${escapeHtml(s.goal || "No goal")} ${s.status} • ${formatDateTime(s.startedAt)}
`,
)
.join("");
sessionsEl.innerHTML = list || 'No sessions yet.
';
}
```
--------------------------------
### Enable/Disable UI Controls
Source: https://github.com/ordinalos/milhouse-van-houten/blob/main/ui/public/index.html
Enables or disables the start and stop buttons based on the current running state and whether a goal is set.
```javascript
function updateControls() {
const hasGoal = goalEl.value.trim().length > 0;
startBtn.disabled = running || !hasGoal;
stopBtn.disabled = !running;
}
```
--------------------------------
### GET /api/events - Server-Sent Events Stream
Source: https://context7.com/ordinalos/milhouse-van-houten/llms.txt
Establishes a persistent connection for real-time log streaming. The server broadcasts all stdout/stderr from the loop runner.
```APIDOC
## GET /api/events - Server-Sent Events Stream
### Description
Establishes a persistent connection for real-time log streaming. The server broadcasts all stdout/stderr from the loop runner.
### Method
GET
### Endpoint
/api/events
### Request Example
```bash
curl -N http://127.0.0.1:4173/api/events
```
### Response Example
```
data: [milhouse] Starting run…
data: [milhouse] workdir: /path/to/project
data: [milhouse] state dir: /home/user/.local/share/milhouse/...
data: thread: thread_abc123
data: ================ LOOP 1 = ================
data: thread: thread_abc123
data: ================ LOOP 2 = ================
data: Plan marked DONE. Exiting.
data: [exit] code=0 signal=null
```
### JavaScript EventSource Usage
```javascript
const eventSource = new EventSource('/api/events');
eventSource.onmessage = (event) => {
console.log('Log:', event.data);
// Check for thread ID
const threadMatch = event.data.match(/thread:\s*([0-9a-zA-Z-]+)/);
if (threadMatch) {
console.log('Thread ID:', threadMatch[1]);
}
// Check for completion
if (event.data.includes('Plan marked DONE')) {
console.log('Run completed successfully');
}
};
eventSource.onerror = () => {
console.log('Connection lost, reconnecting...');
};
```
```
--------------------------------
### POST /api/start
Source: https://context7.com/ordinalos/milhouse-van-houten/llms.txt
Initiates a new Codex agent run with a specified goal, creating an implementation plan and executing build tasks.
```APIDOC
## POST /api/start
### Description
Initiates a new Codex agent run with the specified goal. The agent first creates an implementation plan, then iteratively executes tasks until completion.
### Method
POST
### Endpoint
/api/start
### Request Body
- **goal** (string) - Required - The objective for the AI agent.
- **maxIterations** (number) - Required - Maximum number of iterations for the agent loop.
- **workdir** (string) - Required - The directory path where the agent will work.
- **createIfMissing** (boolean) - Optional - Whether to auto-create the workdir if it does not exist.
### Request Example
{
"goal": "Create a REST API with Express that has CRUD operations for users",
"maxIterations": 10,
"workdir": "/path/to/project"
}
### Response
#### Success Response (200)
- **ok** (boolean) - Status of the request.
- **session** (object) - Details of the created session.
#### Response Example
{
"ok": true,
"session": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"goal": "Create a REST API with Express that has CRUD operations for users",
"maxIterations": 10,
"workdir": "/path/to/project",
"stateDir": "/home/user/.local/share/milhouse/L3BhdGgvdG8vcHJvamVjdA",
"startedAt": "2024-01-15T10:30:00.000Z",
"status": "running"
}
}
```
--------------------------------
### View CLI Options
Source: https://github.com/ordinalos/milhouse-van-houten/blob/main/README.md
Display available command-line arguments and options for the UI.
```text
milhouse ui [OPTIONS]
Options:
--host