Guides
Installation
What Jinion needs, how to install and update it, and which terminals work best.
Requirements
| What | Needed |
|---|---|
| Node.js | 22 or later |
| System | macOS or Linux |
| Account | A Claude account on a subscription, such as Pro or Max; for Codex, a ChatGPT login |
| Terminal | Any modern terminal; see recommended terminals for the best fit |
Install
npm i -g @jinion/cliCheck that it worked:
jinion --versionIt prints the version, such as 0.0.1. If your shell says command not found, see
Troubleshooting.
Sign in
Start Jinion in any project:
cd ~/code/my-project
jinionIf you have signed in to Claude on this machine before, the banner shows the account and you're done. If not, type
/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.
When a login expires, sign it in again from the same panel; see Sign in again. To use more than one account, see Switch models and accounts. To work with Codex, see Work with Codex.
Try it without a model
jinion --demo plays a scripted session: questions, edits, test runs and background tasks, without sending anything
to a model. It is a quick way to look around.
jinion --demoType add rate limiting to the api for the full tour, or hello for a short one.
Update
Jinion updates itself. While it is open, it looks for a newer version a little after it starts and every four hours,
and installs it in the background into ~/.jinion/versions, without sudo and without touching the version running.
The right of the status line then says v0.3.520 ready · restart to update, and the next jinion runs the new
version. Your conversations and settings stay.
To update by hand instead, install the latest version again:
npm i -g @jinion/cli@latestTo turn updating off, set "autoUpdates": false in ~/.jinion/settings.json, or JINION_DISABLE_AUTOUPDATER=1 in
your environment.
Uninstall
npm rm -g @jinion/cliJinion's data stays in ~/.jinion. Delete that folder to remove your conversations, memory and settings too. If you
added accounts with /account, remove them first, so they are signed out.
See The ~/.jinion folder.
Recommended terminals
Jinion runs in any terminal that supports colors and the mouse. These also show desktop notifications and report focus, so Jinion only notifies you when you're looking elsewhere:
| Terminal | Notifications |
|---|---|
| Ghostty | Yes |
| iTerm2 | Yes |
| kitty | Yes |
| WezTerm | Yes |
| Warp | Yes |
| foot | Yes |
Inside tmux or screen, and in other terminals, Jinion rings the bell instead. See Set up your terminal.