Troubleshooting

jinion: command not foundCopy Anchor Link

npm installed Jinion in a folder that isn't on your PATH. Find the folder:

npm prefix -g

Add its bin folder to your PATH in your shell profile, such as ~/.zshrc, then open a new terminal:

export PATH="$(npm prefix -g)/bin:$PATH"

jinion --version should print the version now.

You aren't signed in to ClaudeCopy Anchor Link

Open /account, go to the account that says "Not signed in" and press enter. Jinion opens the sign-in in your browser; paste the code the browser shows. To sign an account in again, such as after its login expired, press l on it.

The rule under the prompt shows Manual instead of AutoCopy Anchor Link

Auto mode needs a model that supports it, such as Opus or Sonnet. Switch with /model; the project keeps Auto, and it applies again with a supported model.

Colors are hard to readCopy Anchor Link

Jinion guessed your terminal's background wrong. Set it yourself:

jinion --theme dark

To keep it, add export JINION_THEME=dark to your shell profile.

No notifications show upCopy Anchor Link

• Check that your terminal supports them; see Get notified.
• Notifications only come while the window isn't focused.
• Inside tmux or screen, they become the bell. tmux also needs focus-events on; see Use Jinion inside tmux.
• Check that they're on: /notifications on.

Pasting an image does nothingCopy Anchor Link

• On Linux, install wl-paste (Wayland) or xclip (X11).
• Outside macOS, images over 3.7 MB are refused. Drag a smaller file in instead.

shift+enter sends the messageCopy Anchor Link

Your terminal sends the same key for shift+enter and enter. Use alt+enter, or end the line with \.

I can't select textCopy Anchor Link

Drag to select; Jinion copies the text when you let go. If the wheel and clicks do nothing either, your terminal isn't sending mouse events: in iTerm2, turn on Settings → Profiles → Terminal → Enable mouse reporting.

Selected text doesn't reach the clipboardCopy Anchor Link

Over SSH, Jinion copies through your terminal (OSC 52). In iTerm2, turn on Settings → General → Selection → Applications in terminal may access clipboard. On Linux, install wl-copy, xclip or xsel. For your terminal's own selection, hold shift while you drag (option in iTerm2).

An MCP server shows as failedCopy Anchor Link

Open /mcp and go to the server: its error shows below the list. Servers from a project's .mcp.json stay off until you turn them on there. A claude.ai connector that shows "not signed in" connects in your claude.ai settings.

Record a debug logCopy Anchor Link

When something goes wrong and you want to report it, run the session again with --debug:

jinion --debug

Jinion writes what it sends to the model and what comes back to ~/.jinion/logs/<time>.jsonl, one JSON line per record, and prints the path when you quit.

Get helpCopy Anchor Link

Open an issue on GitHub with what you did, what you expected, and what happened. Attach a debug log if you can.