File size: 1,398 Bytes
9a70a84 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 | # CLI And Server Surface
## CLI
Recommended shipped commands:
```text
nexum doctor --model /models/Nexum
nexum chat --model /models/Nexum --prompt "Summarize this workspace."
nexum agent --model /models/Nexum --prompt "Inspect this workspace." --workspace /workspace
nexum tools list
nexum tools exec-smoke
nexum templates list
nexum serve --model /models/Nexum
nexum status self-correction
nexum status self-improvement
nexum outcome record --model /models/Nexum --session-id SESSION --turn-id TURN --score SCORE --evidence-sha256 DIGEST
```
## Server
OpenAI-compatible endpoints:
```text
GET /health
GET /v1/models
POST /v1/chat/completions
POST /v1/responses
```
Nexum-native endpoints:
```text
GET /tools
POST /agent/run
POST /tools/execute
POST /outcomes/record
GET /self-correction/status
GET /self-improvement/status
GET /templates
POST /model/validate
```
Server behavior:
- validate and load the full Nexum folder before binding the socket
- keep model files read-only
- keep session model state under `NEXUM_STATE_DIR`
- keep mutable workspace tools and action receipts under `.nexum/`
- expose tool schemas
- persist observations
- return correction receipts
- redact secrets from logs
- require bearer authentication for non-loopback binding
- keep HTTP tool execution disabled unless explicitly enabled
- require the same authenticated mutation gate for outcome credit
|