CLI ToolsMay 14, 2026·2 min read

OrChat — OpenRouter Chat CLI (Token Analytics)

Chat with OpenRouter models in the terminal with streaming, token/cost analytics, file attachments, and safe command gating; verified 81★ via PyPI.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
CLI Tool
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install 4d3857fd-da9e-5355-bce9-eb0059e200b6 --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

Chat with OpenRouter models in the terminal with streaming, token/cost analytics, file attachments, and safe command gating; verified 81★ via PyPI.

Best for: Terminal-native chat + controlled shell execution workflows

Works with: Python 3.9+ · OpenRouter API key · local files/images (attachments)

Setup time: 5–15 minutes

Key facts (verified)

  • GitHub: 81 stars · 6 forks · pushed 2026-02-15.
  • License: MIT · owner avatar + repo URL verified via GitHub API.
  • README-backed entrypoint: pip install orchat.

Main

  • Use orchat --setup to store your OpenRouter key and defaults; then pick models dynamically during sessions.

  • Use attachments (@file) to include local context while keeping paths safe and sizes bounded.

  • Rely on command gating: OrChat shows a risk panel before you approve shell commands requested by the assistant.

  • Track token usage and cost from API-reported counts to keep sessions budgeted.

Source-backed notes

  • README describes OpenRouter-based streaming chat, token/cost tracking, and conversation persistence.
  • README explicitly documents a command risk panel (safe/warning/critical) before execution approval.

FAQ

  • Do I need OpenRouter credit?: Yes — the README mentions 402 errors when your OpenRouter balance is insufficient.
  • Can I disable command execution?: Only approve what you trust; treat the risk panel as your gate.
  • How do I keep costs down?: Pick cheaper models and watch token analytics during long sessions.
🙏

Source & Thanks

Source: https://github.com/oop7/OrChat > License: MIT > GitHub stars: 81 · forks: 6

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets