CLI Guide
This guide helps you get started with the Saiki CLI and includes a comprehensive list of commands you can run with Saiki CLI.
Saiki CLI is the easiest way to get started with AI agents.
Some of the cool things you can do with Saiki CLI:
- Talk to any LLM in your terminal
- Create long-lived AI agents with tools, knowledge and memories. Example: a productivity agent that integrates with your linear and github.
- Deploy these agents either locally or on the cloud
- Talk to these agents on any application - discord, telegram, slack, cursor, claude desktop, etc.
- Start building your own AI applications - get started with building your own Cursor!
saiki create-app
More CLI commands coming soon!
Request a CLI command by creating an issue here.
See all available options and flags:
saiki -h
Launch the interactive CLI:
saiki
Start saiki CLI with a different LLM
# openai
saiki -m gpt-4o
# anthropic
saiki -m claude-4-sonnet-20250514
# google
saiki -m gemini-2.0-flash
Start saiki with a different config file
This allows you to configure saiki CLI to use a different AI agent
saiki --agent <path_to_agent_config_file>
Check Configuration Guide to understand more about saiki config files
Require all MCP servers to connect successfully
By default, Saiki uses "lenient" mode where individual servers can fail to connect without preventing startup. Use the --strict flag to require all servers to connect successfully:
saiki --strict
This overrides any individual connectionMode settings in your MCP server configurations. See MCP Configuration for more details on connection modes.
Run a specific command with Saiki CLI:
saiki find all .sh files in this directory
or do the same with gemini:
saiki -m gemini-2.0-flash find all files in this directory
Saiki CLI can accept any command - if it doesn't see it as an in-built command, it will fire a single run CLI with that request
For instance, in the above command, the query "find all .sh files in this directory" will start Saiki Agent, send it this query, process the response, and then exit.
Start a telegram bot
saiki --mode telegram
To use a specific agent config file for the telegram bot:
saiki --mode telegram --agent ./telegram-agent-config.yml
Start a discord bot
saiki --mode discord
To use a specific agent config file for the discord bot:
saiki --mode discord --agent ./discord-agent-config.yml
Start saiki as an MCP server
saiki --mode mcp
With this, you can now connect this agent to Cursor, claude desktop, or even other Saiki agents!
Check Using saiki as an MCP Server to understand more about MCP servers.
Group MCP servers with saiki
saiki mcp --group-servers
This starts Saiki as an MCP server that aggregates and re-exposes tools from multiple configured MCP servers. This is useful when you want to access tools from multiple MCP servers through a single connection.
To use a specific config file:
saiki mcp --group-servers -a ./saiki-tools.yml
Check Using Saiki to group MCP servers to understand more about MCP server aggregation.
Change log level for saiki CLI
To change the logging level, set environment variable SAIKI_LOG_LEVEL to 'info', 'debug', or 'silly'. Default is 'info'.
ex: for debug logs:
SAIKI_LOG_LEVEL=debug
saiki what is the time
Project setup commands
These commands will help you get started creating your own AI application using Saiki
Setup a fresh typescript project using saiki-core
saiki create-app
Add saiki into an existing typescript project
saiki init-app
Check Building with Saiki Guide for more information!
Coming soon!
Some of the CLI commands we're working on!