sinores-cli

Terminal AI agent for code operations via Moonshot or DeepSeek API.

GitHub · npm

---

Features

• Terminal-native interface. No browser context switching.
• File-system operations with explicit permission model keyed by tool:path.
• Persistent sessions stored in ~/.sinores/sessions/.
• Session resume and export to Markdown.
• Auto-truncation of history near context limits.
• @<query> inline file picker for attaching local files as context.
• Live reasoning and content streaming (reasoning is preserved even if you abort).
• Supports Moonshot (Kimi) and DeepSeek models.
• Interactive model selector (/model) and settings editor (/settings) without leaving the terminal.

Requirements

• Node.js >= 18
• ESM ("type": "module")
• Moonshot or DeepSeek API key

Installation

npm install -g sinores-cli

Then run:

sinores

Configuration

The CLI reads config from ~/.sinores/config.json (created automatically on first run, or via --init-config).

Quick start

sinores --init-config

Then edit ~/.sinores/config.json:

{
  "provider": "moonshot",
  "model": "kimi-k2.6",
  "moonshotApiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "deepseekApiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "maxRounds": 50
}

Supported providers and models

Provider	Models
moonshot	kimi-k2.6
deepseek	deepseek-chat, deepseek-reasoner

Priority

1. moonshotApiKey / deepseekApiKey in ~/.sinores/config.json
2. Environment variable (MOONSHOT_API_KEY or DEEPSEEK_API_KEY)
3. SINORES_PROVIDER and SINORES_MODEL env vars override config values

Interactive configuration

You can change settings without editing JSON manually:

/settings   # open the interactive config editor
/model      # open the interactive provider + model picker

Both work inline inside the chat — no need to exit the agent.

Usage

Start a new session:

sinores

Resume a previous session:

sinores --resume

Sessions

Conversations are auto-saved to ~/.sinores/sessions/. Use --resume on startup or /resume in the prompt to restore a previous session. Use /new to discard the current session and start a new one. Use /export to write the current session to a Markdown file in the current working directory.

History is truncated automatically when approaching the model's context limit.

Permission Model

Every file write, edit, delete, or shell command requires explicit approval. Approvals are scoped to the current session and keyed by tool:path. An approval granted for one operation does not extend to other paths or subsequent sessions.

Commands

Slash Commands

Command	Action
/goal <description>	Set a goal, plan it, then execute step by step
/init	Scan project tree and generate .sinores/SINORES.md context file
/help	Show available commands
/mode <mode>	Switch mode: chat, agent, code, research
/model	Interactive provider and model selector
/settings	Interactive configuration editor (API keys, model, max rounds)
/export	Save current session to Markdown in CWD
/resume	Browse and restore a previous session
/new	Start a new session
/clear	Reset the conversation (requires double confirmation)

Keyboard Shortcuts

Key	Action
↑ / ↓	Navigate input history
Tab	Autocomplete commands; cycle hints when empty
Ctrl+C	Exit (press twice when idle)
Esc	Abort a running agent
@<query>	Inline file picker for attaching context

Goal Mode Keys

When reviewing or executing a goal plan:

Key	Action
Enter	Approve plan / continue to next step
E	Refine plan with LLM
R	Regenerate plan
Esc	Cancel goal execution

Development

npm run dev              # tsx watch mode
npm run dev -- --resume  # dev mode with session picker
npm run build            # compile TypeScript to dist/
npm start                # run compiled build
npm start -- --resume    # compiled build with session picker
npm test                 # run test suite

License

MIT