CLI Commands
Environment Diagnostics (doctor)
Verify Python versions, file permissions, directory health, Ollama HTTP connectivity, and local model availability.
Last updated: 2026-10-31•v0.1.0
The lastsignal doctor command validates your local development environment before running agent supervision, ensuring you never encounter missing directory permissions or dead local ports during an active test run.
Running Doctor
bash
$lastsignal doctor
[DIAGNOSTICS] Checking environment for Last Signal v0.1.0...
✓ Python Environment: Python 3.12.2 detected (minimum 3.10 required)
✓ Workspace Directory: Write access confirmed for current workspace
✓ Trace Directory: .lastsignal/traces/ exists and is writable
✓ Reports Directory: reports/ exists and is writable
✓ Ollama Connectivity: HTTP 200 OK from http://localhost:11434
✓ Model Availability: 'llama3.2' installed and verified
All systems verified. Last Signal is ready for offline supervision.
Executed Diagnostic Checks
- Python Runtime Version: Verifies Python >= 3.10.
- Directory Write Permissions: Checks that .lastsignal/traces/ and reports/ can be created and written to.
- Ollama HTTP Endpoint: Pings http://localhost:11434/api/tags with a 2-second timeout.
- Model Readiness: Checks whether llama3.2 is listed in the local Ollama catalog.
Common Doctor Warnings & Fixes
| Warning | Root Cause | Resolution |
|---|---|---|
| Ollama Connection Refused | Ollama daemon not running | Start Ollama desktop app or run 'ollama serve'. |
| Model 'llama3.2' not found | Model has not been pulled yet | Run 'ollama pull llama3.2'. |
| Permission Denied (.lastsignal) | Current directory read-only | Run in a directory with write access or check ownership. |