banteg
42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# Tutorials
|
||
|
||
Tutorials are **step-by-step learning paths**. If you’re new, start here and follow them in order.
|
||
|
||
If you already know what you want to do (e.g. “enable topics” or “fetch a file”), jump to **How-to**.
|
||
|
||
## Before you start
|
||
|
||
You’ll need:
|
||
|
||
- A Telegram account + a bot token
|
||
- Python **3.14+** and `uv`
|
||
- At least one engine CLI on your `PATH`: `codex`, `claude`, `opencode`, or `pi`
|
||
|
||
## 1) Install and onboard
|
||
|
||
Get Takopi installed, create a bot token, capture your chat id, and pick a default engine.
|
||
|
||
- [Install & onboard](install-and-onboard.md)
|
||
|
||
## 2) Your first run
|
||
|
||
Run Takopi in a repo, send your first task from Telegram, and learn the two core controls:
|
||
|
||
- reply-to-continue (resume)
|
||
- cancel a run
|
||
|
||
- [First run](first-run.md)
|
||
|
||
## What to do next
|
||
|
||
Once you can run tasks end-to-end, you’ll usually want:
|
||
|
||
- Register a repo as a **project alias**: [How-to: Projects](../how-to/projects.md)
|
||
- Run work on a branch in a dedicated **worktree**: [How-to: Worktrees](../how-to/worktrees.md)
|
||
- Keep long-running work organized in threads: [How-to: Topics](../how-to/topics.md)
|
||
|
||
When you need exact knobs and defaults:
|
||
|
||
- [Reference: Configuration](../reference/config.md)
|
||
- [Reference: Commands & directives](../reference/commands-and-directives.md)
|