Daemon Management
Service Installation
Set up whisp to start automatically on boot.
Service Installation
Set up whisp to start automatically on boot.
Using the Install Command
The easiest way to set up auto-start:
whisp installThis creates the appropriate service file for your system (systemd on Linux, launchd on macOS).
Manual Setup
Linux (systemd)
Create /etc/systemd/system/whisp.service:
[Unit]
Description=Whisp AI Shell Assistant
After=network.target
[Service]
Type=simple
User=your-username
Environment=OPENAI_API_KEY=sk-your-key
ExecStart=/usr/local/bin/whisp start --foreground
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.targetThen enable and start:
sudo systemctl daemon-reload
sudo systemctl enable whisp
sudo systemctl start whispmacOS (launchd)
Create ~/Library/LaunchAgents/com.whisp.daemon.plist:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.whisp.daemon</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/whisp</string>
<string>start</string>
<string>--foreground</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>EnvironmentVariables</key>
<dict>
<key>OPENAI_API_KEY</key>
<string>sk-your-key</string>
</dict>
</dict>
</plist>Load the service:
launchctl load ~/Library/LaunchAgents/com.whisp.daemon.plistUninstall Service
To remove the auto-start service:
whisp uninstallOr manually:
# Linux
sudo systemctl stop whisp
sudo systemctl disable whisp
sudo rm /etc/systemd/system/whisp.service
# macOS
launchctl unload ~/Library/LaunchAgents/com.whisp.daemon.plist
rm ~/Library/LaunchAgents/com.whisp.daemon.plist