fidelity-ai-workspace/docs/services.md

Services

The AI Workspace Service Manager provides one profile-aware lifecycle surface for local services.

Responsibility

The service manager starts, stops, checks, and tails logs. It does not merge service responsibilities.

Service Manager → process lifecycle/status/logs
MCP Server      → read-only context access
Connectors      → raw evidence capture
Agent/Human     → memory promotion

Common Commands

python3 scripts/aiw/services.py status --profile fidelity
python3 scripts/aiw/services.py status --profile fidelity --json
python3 scripts/aiw/services.py doctor --profile fidelity
python3 scripts/aiw/services.py start --profile fidelity
python3 scripts/aiw/services.py stop --profile fidelity
python3 scripts/aiw/services.py logs aiw-context-mcp --profile fidelity

Service Manifest

Services are declared per profile:

profiles/<profile>/services.json

A service can define:

• command;
• kind;
• groups;
• dependencies;
• restart policy;
• doctor checks;
• health checks.

Current Service Types

• process: long-running command with PID/log tracking.
• app-launcher: one-shot command that opens an app/helper.
• mcp: process service exposing an MCP-compatible context server.

Runtime Files

Runtime artifacts are local and ignored:

.aiw/runtime/pids/
.aiw/runtime/logs/
.aiw/runtime/state/

These files are operational state, not project memory.