docs: restructure docs into diataxis (#121)

2026-01-13 15:59:27 +04:00
parent d0e9a51a0f
commit e292c99ab0
52 changed files with 1538 additions and 1255 deletions
@@ -0,0 +1,43 @@
+# Switch engines
+
+Run a one-off message on a specific engine, or set a persistent default for a chat/topic.
+
+## Use an engine for one message
+
+Prefix the first non-empty line with an engine directive:
+
+```
+/codex hard reset the timeline
+/claude shrink and store artifacts forever
+/opencode hide their paper until they reply
+/pi render a diorama of this timeline
+```
+
+Directives are only parsed at the start of the first non-empty line.
+
+## Set a default engine for the current scope
+
+Use `/agent`:
+
+```
+/agent
+/agent set claude
+/agent clear
+```
+
+- Inside a forum topic, `/agent set` affects that topic.
+- In normal chats, it affects the whole chat.
+- In group chats, only admins can change defaults.
+
+Selection precedence (highest to lowest): resume token → `/engine` directive → topic default → chat default → project default → global default.
+
+## Engine installation
+
+Takopi shells out to engine CLIs. Install them and make sure they’re on your `PATH`
+(`codex`, `claude`, `opencode`, `pi`). Authentication is handled by each CLI.
+
+## Related
+
+- [Commands & directives](../reference/commands-and-directives.md)
+- [Config reference](../reference/config.md)
+