Seher

Seher is a CLI tool that waits for an agent's Rate Limit to reset, then executes a specified prompt using Claude Code, Codex, or other compatible CLIs.

How it works

By default, it retrieves Chrome's cookie information and uses it to call Claude's API to get the Rate Limit reset time. The browser and profile from which cookies are retrieved can be changed with options.

Supported Browsers

Seher supports reading cookies from the following browsers:

Chromium-based browsers

Chrome
Microsoft Edge
Brave
Chromium
Vivaldi
Comet (Perplexity AI browser)
Dia (The Browser Company)
ChatGPT Atlas (OpenAI browser)

Other browsers

Firefox (all platforms)
Safari (macOS only - uses sandboxed cookies location)

All Chromium-based browsers use the same cookie storage format and encryption. Firefox uses a different SQLite schema without encryption. Safari uses a proprietary binary format on macOS.

Note: On recent versions of macOS, Safari cookies are stored in a sandboxed location: ~/Library/Containers/com.apple.Safari/Data/Library/Cookies/Cookies.binarycookies

Installation

Homebrew (macOS / Linux) - recommended

brew install smartcrabai/tap/seher

Pre-built binaries

Pre-built binaries are available for macOS and Linux (x86_64 and aarch64):

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/smartcrabai/seher/releases/latest/download/seher-installer.sh | sh

Build from source

cargo install --git https://github.com/smartcrabai/seher

Usage

# Default
seher "fix bugs"
# Launch vim to input a prompt
seher
# Change the browser and profile from which cookies are retrieved
seher --browser edge --profile "Profile 1" "fix bugs"
# Use Firefox
seher --browser firefox --profile "default-release" "fix bugs"
# Use Safari (macOS only)
seher --browser safari "fix bugs"
# Most Claude Code options can be used as is
seher --chrome --disallowedTools "Bash(git:*)" --permission-mode bypassPermissions "fix bugs"
# Use model level (resolved via agent's models map)
seher --model high "fix bugs"
seher -m low "fix bugs"

It is recommended to alias frequently used options as follows:

alias shr="seher --profile 'Profile 1' --permission-mode bypassPermissions"

Configuration

You can customize seher's behavior by creating ~/.config/seher/settings.json or ~/.config/seher/settings.jsonc (JSONC supports // and /* */ comments and trailing commas). If neither file exists, the default configuration (using claude with no extra arguments) is applied.

Settings

Field	Type	Description
`agents`	array	List of agents to use
`agents[].command`	string	Executable name (e.g. `"claude"`, `"codex"`, `"opencode"`)
`agents[].args`	array of strings	Additional arguments (optional)
`agents[].models`	object	Model level mapping (optional)
`agents[].arg_maps`	object	Exact-match mapping from trailing CLI tokens to replacement token arrays (optional)
`agents[].env`	object	Environment variables to set when running the agent (optional)
`agents[].provider`	string or null	Rate limit provider override (optional, see below)

Example

{
  "agents": [
    {
      "command": "claude",
      "args": ["--model", "{model}"],
      "models": {
        "high": "opus",
        "medium": "sonnet",
        "low": "haiku",
        "sonnet": "sonnet"
      },
      "arg_maps": {
        "--danger": ["--permission-mode", "bypassPermissions"]
      },
      "env": {
        "CLAUDE_CODE_MAX_TURNS": "100"
      }
    },
    {
      "command": "opencode",
      "provider": "copilot",
      "args": ["--model", "{model}", "--yolo"],
      "models": {
        "high": "github-copilot/gpt-5.4",
        "medium": "github-copilot/gpt-5.4",
        "low": "github-copilot/claude-haiku-4.5"
      }
    },
    {
      "command": "claude",
      "provider": null,
      "args": ["--model", "{model}"],
      "models": {
        "medium": "MiniMax-M2.5",
        "low": "MiniMax-M2.5"
      },
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
        "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic"
      }
    }
  ]
}

The {model} placeholder in args is resolved based on the value passed to --model. If the key exists in the models map, it is replaced with the mapped value; otherwise the value is used as-is. When --model is not specified, any argument containing {model} is skipped.

arg_maps rewrites each trailing CLI token independently using exact-match keys. A mapping value can expand one input token into multiple output tokens, while unmapped tokens are passed through unchanged. For example, with the sample configuration, seher --danger "fix bugs" adds --permission-mode bypassPermissions when Claude is selected, or --yolo when Copilot is selected.

The provider field controls rate limit tracking. If omitted, the provider is inferred from the command name (claude → claude.ai, codex → chatgpt.com, copilot → github.com). Setting it to null disables rate limit checking for that agent, making it act as an unconditional fallback. Setting it to a string (e.g. "codex" or "copilot") uses that provider's rate limit regardless of the command name. When multiple agents are configured, seher preferentially selects agents that are not rate-limited; agents with provider: null are used as a last resort.

For Codex, seher reads chatgpt.com browser cookies, fetches an access token from https://chatgpt.com/api/auth/session, and then calls https://chatgpt.com/backend-api/wham/usage. The request intentionally keeps headers minimal and does not require hard-coding a bearer token in your config.

The env field specifies environment variables to inject when launching the agent. This is useful for switching API keys or base URLs to route a standard command (e.g. claude) to a different backend.

sehercode 0.0.20