fidelity-ai-workspace/scripts/aiw/README.md

AI Workspace Service Manager

The service manager is the local lifecycle layer for AI Workspace services.

It reads profiles/<profile>/services.json, starts/stops enabled services, records logs under .aiw/runtime/logs/, and keeps PID/state files under .aiw/runtime/.

Common commands

python3 scripts/aiw/services.py status --profile fidelity
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 mattermost-proxy --profile fidelity

Start a subset by group:

python3 scripts/aiw/services.py start --profile fidelity --group communication
python3 scripts/aiw/services.py start --profile fidelity --group inbox

Current Fidelity services

• mattermost-proxy: runs the local Mattermost proxy mirror.
• mattermost-desktop: launches Mattermost Desktop through the proxy.
• photo-inbox: runs the local HTTP photo receiver.
• aiw-context-mcp: reserved placeholder for the future read-only context MCP server.

The service manager unifies startup and status. It does not move capture behavior into the MCP.

Tests

python3 scripts/aiw/test_services.py