# 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.

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

## Common Commands

```bash
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:

```text
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:

```text
.aiw/runtime/pids/
.aiw/runtime/logs/
.aiw/runtime/state/
```

These files are operational state, not project memory.