Files
takopi/docs/how-to/switch-engines.md

43 lines
1.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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-id>` directive → topic default → chat default → project default → global default.
## Engine installation
Takopi shells out to engine CLIs. Install them and make sure theyre 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)