Skip to main content

The process is running but the app is not ready

Check health:
/api/health always returns 200. Inspect modelReady and startupError. Use /api/ready when automation needs an HTTP readiness gate.

The default port is in use

Set TASKBEAN_PORT, taskbean_PORT, or PORT, or set port in ~/.taskbean/config.json. Environment variables take precedence over the config file. On Windows, inspect the current listener:

Taskbean appears twice on PATH

On Windows:
Remove the unwanted npm or binary installation, then run bean upgrade.

Codex cannot write task data

Chronicle evidence is unavailable

Task reports continue from canonical tasks when Chronicle is disabled, unavailable by policy, or missing local session data.

NPU usage shows zero on non-English Windows

The current PDH sampler uses the English GPU Engine counter name. Localized Windows installations can report 0% even when inference works. Check model readiness and execution-provider data instead of relying only on the NPU chart.

Voice input is unavailable

Confirm Windows speech and microphone permissions, then review the speech settings in ~/.taskbean/config.json.
Last modified on July 29, 2026