Conversation modes¶
Takopi can handle follow-up messages in two ways: chat mode (auto-resume) or stateless (reply-to-continue).
During onboarding, you chose a workflow (assistant, workspace, or handoff) that automatically configured this for you:
| Workflow | Session mode | Topics | Resume lines |
|---|---|---|---|
| assistant | chat | off | hidden |
| workspace | chat | on | hidden |
| handoff | stateless | off | shown |
This page explains what those settings mean and how to change them.
Chat mode (auto-resume)¶
What it feels like: a normal chat assistant.
You
explain what this repo does
Takopi
done · codex · 8s ...
You
now add tests
Takopi treats the second message as a continuation. If you want a clean slate, use:
You
/new
Tip: set a default agent for this chat with /agent set claude.
Stateless (reply-to-continue)¶
What it feels like: every message is independent until you reply.
You
explain what this repo does
Takopi
done · codex · 8s ... codex resume abc123
To continue the same session, reply to a message with a resume line:
Takopi
done · codex · 8s
You
now add tests
Changing your settings¶
You can manually change these settings in your config file:
[transports.telegram]
session_mode = "chat" # "chat" or "stateless"
show_resume_line = false # true or false
Or re-run onboarding to pick a different workflow:
takopi --onboard
Resume lines in chat mode¶
If you enable chat mode (or topics), Takopi can auto-resume, so you can hide resume lines for a cleaner chat. Resume lines are still shown when no project context is set, so replies can branch there.
If you prefer always-visible resume lines, set:
[transports.telegram]
show_resume_line = true
Reply-to-continue still works¶
Even in chat mode, replying to a message with a resume line takes precedence and branches from that point.
Related¶
Next¶
Now that you know which mode you want, move on to your first run: