docs(#64): one owner per fact, truth re-read from the boxes, readable pages #65

Merged
dank merged 16 commits from docs/64-bundle-audit-dedupe into main 2026-10-21 02:43:28 -07:00
17 changed files with 55 additions and 55 deletions
Showing only changes of commit 62a70caebb - Show all commits

No files matched your search

+3 -3
View File
@@ -187,7 +187,7 @@ Currently configured providers:
| `llamacpp (dankserver)` | `http://192.168.0.235:7770/v1` | `frank-default-small` (Qwen3.6-35B-A3B FP8, moe-cache 2048) | RTX 3090 |
| `llamacpp (dankclaw)` | `http://192.168.0.143:7770/v1` | `frank-default-large` (Qwen3.8-Flash-Next Q4_0 ROCmFP4 Strix) | RTX 4070 Max-Q |
See [[models|models]] for the complete `models.json` reference.
See [models](/pi/models.md) for the complete `models.json` reference.
---
@@ -235,6 +235,6 @@ When `lastChangelogVersion` is behind pi's internal version, pi prompts for migr
## See Also
- [pi](../pi/index.md) — Pi configuration overview
- [[models|models]] — Provider and model definitions
- [models](/pi/models.md) — Provider and model definitions
- [Pi Packages](/pi/packages/index.md) — Installed package documentation
- [[skills|skills]] — Installed skill documentation
- [skills](/pi/skills.md) — Installed skill documentation
+5 -5
View File
@@ -31,7 +31,7 @@ Current providers in `models.json` (verified 2026-08-27, after the
| **Base URL** | `http://192.168.0.235:7770/v1` |
| **API** | `openai-completions` |
| **Auth** | None (EMPTY) |
| **Host** | [[dankserver|dankserver]] |
| **Host** | [dankserver](/system/dankserver.md) |
#### Models
@@ -52,7 +52,7 @@ value succeed.
| **Base URL** | `http://192.168.0.143:7770/v1` |
| **API** | `openai-completions` |
| **Auth** | None (EMPTY) |
| **Host** | [[dankclaw|dankclaw]] |
| **Host** | [dankclaw](/system/dankclaw.md) |
> 2026-08-22: `frank-default-large` moved from `:52625` to `:7770` on
> Dankclaw (operator request: the primary inference server sits on the
@@ -142,6 +142,6 @@ The subagent model IDs (`frank-default-small`, `frank-default-large`) resolve ag
## See Also
- [[settings|settings]] — Main configuration file
- [[dankserver|dankserver]] — Primary llama.cpp server
- [[dankclaw|dankclaw]] — Secondary llama.cpp server
- [settings](/core/settings.md) — Main configuration file
- [dankserver](/system/dankserver.md) — Primary llama.cpp server
- [dankclaw](/system/dankclaw.md) — Secondary llama.cpp server
+2 -2
View File
@@ -64,5 +64,5 @@ No per-model limit exists. All caps are global to a run or a session. They do no
## See Also
- [[settings|settings]] — Subagent configuration
- [[models|models]] — Model definitions
- [settings](/core/settings.md) — Subagent configuration
- [models](/pi/models.md) — Model definitions
+2 -2
View File
@@ -88,6 +88,6 @@ live `free` reading.
## See Also
- [[dankserver|dankserver]] — the main-model box (frank-archon)
- [dankserver](/system/dankserver.md) — the main-model box (frank-archon)
- [/tools/gitea/index.md](/tools/gitea/index.md) — Gitea stack on this host
- [[network|network]] — Network topology
- [network](/system/network.md) — Network topology
+2 -2
View File
@@ -84,6 +84,6 @@ The old page (verified 2026-08-28) listed an RTX 3090, 60 GiB RAM, and a
## See Also
- [[dankclaw|dankclaw]] — the other inference box (dragoon + zealot)
- [[network|network]] — Network topology
- [dankclaw](/system/dankclaw.md) — the other inference box (dragoon + zealot)
- [network](/system/network.md) — Network topology
- [/core/statusline.md](/core/statusline.md) — where these models surface in the TUI
+2 -2
View File
@@ -70,7 +70,7 @@ graph LR
## See Also
- [[cachyos|cachyos]] — Operating system documentation
- [[noctalia-shell|noctalia-shell]] — Desktop shell
- [cachyos](/tools/cachyos.md) — Operating system documentation
- [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell
- [niri](niri/index.md) — Compositor
- ](ghostty/index.md) — Terminal configuration
+2 -2
View File
@@ -108,5 +108,5 @@ CachyOS with Niri ships with a curated set of applications:
- ](../system/index.md) — system overview
- [niri](niri/index.md) — Compositor documentation
- [[noctalia-shell|noctalia-shell]] — Desktop shell documentation
- [[applications|applications]] — Application reference
- [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell documentation
- [applications](/tools/applications.md) — Application reference
+2 -2
View File
@@ -83,5 +83,5 @@ Note: the full-stack repo compose (`dankclaw/compose.yaml`) maps Gitea HTTP to h
## See Also
- ](index.md) — index with management commands
- [[management|management]] — operations, boot persistence, incident
- [[data-persistence|data-persistence]] — volumes and backups
- [management](/tools/gitea/management.md) — operations, boot persistence, incident
- [data-persistence](/tools/gitea/data-persistence.md) — volumes and backups
+4 -4
View File
@@ -14,7 +14,7 @@ verified: 2026-10-09
Clients (workstations, agent hosts) reach Gitea over plain HTTP on the LAN:
`http://192.168.0.143:3000/dank/<repo>.git`. Authentication is a Gitea HTTP token sent as
the password for user `dank`. SSH is available on `:2222` (see
[[architecture|architecture]]); HTTP + token is what the agent hosts use.
[architecture](/tools/gitea/architecture.md)); HTTP + token is what the agent hosts use.
## The law: the token never enters a URL, a config file, or a shell rc
@@ -93,6 +93,6 @@ until it is deleted in the UI, so delete it there as part of the rotation.
## See Also
- [[index|index]] — Gitea on dankclaw
- [[management|management]] — server-side operations
- [[architecture|architecture]] — ports (3000 HTTP, 2222 SSH) and the Caddy front
- [Gitea directory index](/tools/gitea/index.md) — Gitea on dankclaw
- [management](/tools/gitea/management.md) — server-side operations
- [architecture](/tools/gitea/architecture.md) — ports (3000 HTTP, 2222 SSH) and the Caddy front
+2 -2
View File
@@ -64,5 +64,5 @@ Set `PGPASSWORD` from `/home/dank/Containers/gitea/env` (mode 0600, `GITEA_DB_PA
## See Also
- ](index.md) — index with management commands
- [[management|management]] — operations and boot persistence
- [[architecture|architecture]] — network and ports
- [management](/tools/gitea/management.md) — operations and boot persistence
- [architecture](/tools/gitea/architecture.md) — network and ports
+2 -2
View File
@@ -39,13 +39,13 @@ All data lives on host bind mounts under `/home/dank/Containers/gitea/` (fleet s
| `/home/dank/Containers/gitea/postgres/` | PostgreSQL data files |
| `/home/dank/Containers/gitea/env` | EnvironmentFile (mode 0600; `GITEA_DB_PASSWORD`) |
See [[data-persistence|data-persistence]] for backup and restore.
See [data-persistence](/tools/gitea/data-persistence.md) for backup and restore.
## Boot Persistence
User-level linger is enabled for `dank`. The units start at host boot without a login. Each unit carries `[Install] WantedBy=default.target`; the podman generator applies it. The legacy podman-compose stack had no units and did not survive reboots (incident 2026-08-16).
See [[management|management]] for boot persistence details and troubleshooting.
See [management](/tools/gitea/management.md) for boot persistence details and troubleshooting.
## Repo Copies
+4 -4
View File
@@ -100,7 +100,7 @@ Verify the fix on the next host reboot.
## See Also
- ](index.md) — index
- [[client-access|client-access]] — how client hosts authenticate (token + credential store)
- [[architecture|architecture]] — network topology
- [[data-persistence|data-persistence]] — backups
- [[containers|containers]] — quadlet reference
- [client-access](/tools/gitea/client-access.md) — how client hosts authenticate (token + credential store)
- [architecture](/tools/gitea/architecture.md) — network topology
- [data-persistence](/tools/gitea/data-persistence.md) — backups
- [containers](/engineering/infra/containers.md) — quadlet reference
+2 -2
View File
@@ -222,12 +222,12 @@ curl -s http://192.168.0.143:7771/v1/chat/completions -d '{
"chat_template_kwargs": {"enable_thinking": false}}'
```
See [[noctalia-shell]] for IPC integration patterns.
See [Noctalia Shell](/tools/noctalia-shell.md) for IPC integration patterns.
---
## See Also
- [[noctalia-shell|noctalia-shell.md]] — Desktop environment integration
- [noctalia-shell.md](/tools/noctalia-shell.md) — Desktop environment integration
- [niri](niri/index.md) — Compositor configuration
- [`handy --help`](https://github.com/cjpais/Handy) — CLI reference
+6 -6
View File
@@ -178,17 +178,17 @@ The `environment { render-node "/dev/dri/renderD129" }` pin found in the
hybrid; pin kept the iGPU as display owner and sidesteps the suspend/resume
deadlock documented in the sleep-wake investigation). Deploying that base
file on blankpad pins a render node that does not exist — this is why
blankpad runs the `zz-blankpad` override layer (see [[index|the per-host
symlink matrix]]).
blankpad runs the `zz-blankpad` override layer (see [the per-host symlink
matrix](/tools/niri/index.md)).
## Reload
`niri msg action load-config-file` reloads live. Never `SIGHUP` the process
— see [[tips]].
— see [Niri Tips and Gotchas](/tools/niri/tips.md).
## See Also
- [Niri](/tools/niri/index.md) — compositor overview and config layout
- [[tips|tips]] — reload path, `niri msg layers/casts`, includes
- [[noctalia-shell|noctalia-shell]] — notification shown on desk switch
- [[cachyos|cachyos]] — operating system
- [tips](/tools/niri/tips.md) — reload path, `niri msg layers/casts`, includes
- [noctalia-shell](/tools/noctalia-shell.md) — notification shown on desk switch
- [cachyos](/tools/cachyos.md) — operating system
+10 -10
View File
@@ -85,18 +85,18 @@ Column-based scrollable tiling. Columns are cycled with Mod+Left/Right (or Mod+H
| File | Type | Description |
|------|------|-------------|
| [[action-reference|action-reference.md]] | reference | Curated reference of niri actions |
| [[default-bindings|default-bindings.md]] | reference | Default key bindings organized by category |
| [[key-bindings-syntax|key-bindings-syntax.md]] | reference | KDL configuration syntax for key bindings |
| [[tips|tips.md]] | howto | Practical tips for working with niri |
| [[displays|displays.md]] | reference | Desk-profile system: EDID-keyed outputs, hotplug auto-switch, portrait transforms, GPU notes |
| [[keybindings|keybindings.md]] | reference | GENERATED keybinding cheat sheet (scripts/gen-keybinds.sh) |
| [[screenshots|screenshots.md]] | reference | Screenshot bind matrix: flameshot vs niri-native, 2+ output limits, all-monitor capture |
| [action-reference.md](/tools/niri/action-reference.md) | reference | Curated reference of niri actions |
| [default-bindings.md](/tools/niri/default-bindings.md) | reference | Default key bindings organized by category |
| [key-bindings-syntax.md](/tools/niri/key-bindings-syntax.md) | reference | KDL configuration syntax for key bindings |
| [tips.md](/tools/niri/tips.md) | howto | Practical tips for working with niri |
| [displays.md](/tools/niri/displays.md) | reference | Desk-profile system: EDID-keyed outputs, hotplug auto-switch, portrait transforms, GPU notes |
| [keybindings.md](/tools/niri/keybindings.md) | reference | GENERATED keybinding cheat sheet (scripts/gen-keybinds.sh) |
| [screenshots.md](/tools/niri/screenshots.md) | reference | Screenshot bind matrix: flameshot vs niri-native, 2+ output limits, all-monitor capture |
---
## See Also
- [[noctalia-shell|noctalia-shell]] — Desktop shell integration
- [[displays|displays]] — Multi-monitor desk rig configuration
- [[cachyos|cachyos]] — Operating system
- [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell integration
- [displays](/tools/niri/displays.md) — Multi-monitor desk rig configuration
- [cachyos](/tools/cachyos.md) — Operating system
+3 -3
View File
@@ -75,6 +75,6 @@ tr '\0' '\n' < /proc/$(pgrep -x niri | head -1)/environ | grep ^PATH # spawn-s
## See Also
- [[displays|displays.md]] — desk profiles: 1 output portable vs 2 docked
- [[keybindings|keybindings.md]] — generated cheat sheet (source of the binds)
- [[noctalia-shell|noctalia-shell]] — shell settings on Mod+Shift+O
- [displays.md](/tools/niri/displays.md) — desk profiles: 1 output portable vs 2 docked
- [keybindings.md](/tools/niri/keybindings.md) — generated cheat sheet (source of the binds)
- [noctalia-shell](/tools/noctalia-shell.md) — shell settings on Mod+Shift+O
+2 -2
View File
@@ -434,6 +434,6 @@ to document). A dependency table is a claim about the machine: check it before w
## See Also
- [niri](niri/index.md) — Compositor configuration
- [[displays|displays]] — Display layout
- [[cachyos|cachyos]] — Operating system documentation
- [displays](/tools/niri/displays.md) — Display layout
- [cachyos](/tools/cachyos.md) — Operating system documentation
- [`noctalia msg --help`](https://github.com/Noctalia/noctalia) — Full command reference