Kesoku (name inspired by 結束/Kessoku) is a minimal, readable, and modular autonomous AI agent designed for seamless integration with chat platforms (like Discord and one-shot CLI chat) powered by SQLite message persistence, session management, and extensible tool calling.
For detailed guides on advanced configuration, platform bots (Discord, WeChat, Google Chat), cron jobs, and internal architecture, visit the official documentation: 👉 https://codescv.github.io/kesoku/
Install Kesoku globally as a CLI tool using uv:
uv tool install git+https://github.com/codescv/kesoku.gitTo initialize a workspace and configuration template:
kesoku init -c private/config.tomlStart an interactive CLI session with your agent using the chat subcommand:
# Start a new chat session
kesoku chat -c private/config.toml "What is 25 + 15?"
# Resume the latest active chat session
kesoku chat -c private/config.toml -z "And multiply that by 2."
# List all persistent chat sessions
kesoku chat -c private/config.toml -l