Docs / Reference
sentientd options
sentientd is the Sentient monitor. It runs as root under systemd, reads kernel events and agent session logs, and serves the local API that sen uses.
Flags
Set flags on the ExecStart line of /etc/systemd/system/sentientd.service, then run sudo systemctl daemon-reload and sudo systemctl restart sentientd.
| Flag | Default | Description |
|---|---|---|
--data-dir | /opt/sentient/data | Directory holding sentient.db. |
--socket | /run/sentient/sentientd.sock | Unix socket for the local API. |
--socket-group | sentient | Group allowed to connect to the socket. Empty means owner only. |
--home | /root, /home/* | Home directory whose ~/.claude/projects to read. Repeatable. |
--poll-interval | 2s | How often session logs are checked for new records. |
--integrity-interval | 1h | How often the full hash-chain check runs. |
Examples
Watch one account only
ExecStart=/opt/sentient/bin/sentientd --home /home/agentWatch two accounts
ExecStart=/opt/sentient/bin/sentientd --home /home/agent --home /home/ciFiles
| Path | Description |
|---|---|
/opt/sentient/bin/ | sentientd and sen binaries. |
/opt/sentient/data/sentient.db | The record. SQLite, root-only, hash-chained. |
/run/sentient/sentientd.sock | The local API socket. |
/etc/systemd/system/sentientd.service | The systemd unit. |
Logs
journalctl -u sentientd -f