Repository navigation
Releases
NekoTrail v0.26.1
Install in one line
- New install on a Mac:
curl -fsSL https://harshil-jani.github.io/nekotrail/install.sh | sh. It downloads the latest release, puts NekoTrail in Applications and opens it, with noxattrstep. The .dmg still works as before.
Fixes
- Todo items not started yet sit on one line with their circle again, instead of a circle above centred text.
- A finished reply shows its time once, on the "Worked for 41s" line. The separate "Done · 41.2s" line under it is gone (stopped and failed turns still say so).
Sharper pictures
- Every screenshot, GIF and clip in the README and on the website is re-shot at 2x, plus new ones of the prompt rail, Environment, chat search and archive on hover.
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.26.0
See your workspace's environment
- New in a workspace's ⋯ menu (and ⌘K): Environment. It lists every variable your agents, terminals and scripts get, grouped by where it comes from: NekoTrail's own and the ports, Repo settings, the workspace's .env files, and your login shell. When a name is set twice, the one that loses says "overridden".
- Values from .env files, and any that look like a secret, stay hidden until you click the eye. Nothing is saved or sent anywhere.
- Moving from Conductor now brings its environment variables into Repo settings too, without replacing any you already set.
Menus that get out of the way
- Every pop-up menu closes when you click anywhere else or press Esc, and Esc puts you back on the button that opened it. Opening one menu closes any other.
- The workspace ... menu opens below the tabs, so a click on Changes or Checks never lands on a menu item.
- The fold arrow on a sidebar section (This week, Waiting on review) is clickable again; the section's ... button no longer sits on top of it.
- An empty section stays out of the sidebar until you drag a workspace, then shows so you can drop into it.
Agents you can tell apart
- Chat tabs, the Hand off choices, Queue rows and Board cards show each agent's logo.
- The Queue's Add form, the search filters and the first-run Try it step use the app's own menus instead of system pop-ups.
Smallest window and polish
- At 900 by 560, Changes keeps Discard, Commit and Send review whole: the file header switches to icon buttons, chat tab titles end in an ellipsis.
- Settings takes focus when it opens and keeps Tab inside it.
- Faint text in the Ports pop-up is easier to read.
- The command palette lists "Show archived workspaces" once.
Quieter chat
- One Done line per reply. Extra ones that stacked up at the end of a chat are gone, and Usage no longer counts that reply twice.
- What a turn would cost at API prices is hidden now. Turn it back on in Settings, Chat.
- The arrow next to a repo in the sidebar folds it, like a click on its name.
Better branch and chat names
- The first message now gets a short English name from your agent's fastest model, the way you would name it yourself. "Apne ko Cityflo mai CAP and PACELC ke concept ko apply krna hain into lets backend" becomes the branch
cityflo-cap-pacelc-backendand the chat "Cityflo CAP PACELC Backend", instead of the first five words. - It runs in the background a few seconds after you send, so nothing waits on it. Until it answers, and if it can't, the branch and chat keep the quick name from your first words, as before.
- A branch that was pushed, renamed by you, or switched by the agent is never touched, and neither is a title you typed or one from a PR or issue.
- Only Claude Code and Codex chats are named this way, through the same CLI and login as the chat itself. Turn it off in Settings, under Workspaces: "Name branches and chats with AI".
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.25.1
New workspace, tidied up
- Pick the repo from a list with each repo's picture. Type to filter it, then press Enter.
- One agent button with every agent's logo in its menu, so nothing spills off the panel on a smaller window.
- Esc in a menu now closes only that menu, and if you close the panel, what you typed is still there next time.
Quicker clean-up and setup
- Hover a workspace in the sidebar to archive it without opening it.
- In the model picker, "Set as default for new chats" makes your pick the model and intelligence every new chat starts with.
- All intelligence levels fit on one row in the model picker.
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.25.0
Answers first
- A finished reply shows only its answer. The steps it took fold into one line, "Worked for 41s · 5 steps". Click it to see them, or press ⌃O to open every reply's steps.
Search inside chats
- Type in the sidebar's Search and press Enter (or click Search all chats) to search every chat in every workspace: your messages, the agent's replies and the commands it ran.
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.24.0
Find your messages
- A rail on the chat's right edge marks each message you sent. Hover it to see the list, then click one to jump there. Shows once you have sent two.
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.23.3
Easier to find your chat
- Every chat tab has a chat-bubble icon. On Changes, Terminal or Preview, the chat you came from keeps an outline, so you can see where to click to get back (or press ⌘1).
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.23.2
Fixes
- Clicking a chat's tab while Changes, Terminal or another view is open goes back to that chat again. It did nothing before.
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.23.1
Fixes
- The macOS build of 0.23.0 failed before it was published, so 0.23.1 carries everything listed under 0.23.0.
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. It updates itself from inside the app. The .AppImage is paused for now; if you use it, switch to the .deb or build from source.
NekoTrail v0.23.0
This build failed before its files were published. Use v0.23.1, which has every change listed here.
NekoTrail v0.22.2
Fixes
- Typing in the terminal works again, and the app no longer freezes after you open a workspace. Starting a workspace's terminal held the database and waited on itself, which stalled everything that reads it, including the Queue.
- A workspace whose folder was deleted says so in its terminal instead of showing a blank tab.
- The Queue shows a loading state, and when empty, one line on what it is with Add task.
Simpler to use
- The sidebar is calmer: one line per workspace, indented under its repo, with a single mark at the end (working, needs you, checks failing, or the PR). The star name, branch, lines changed and overlaps are in the row's tooltip.
- Repos show their owner's real GitHub picture, worked out from the remote and kept on disk, so it shows on every launch and offline. The first letter only shows for repos without a GitHub remote.
- Search, Board, Queue and Usage are plain rows at the top. Grouping, the repo filter, sections, Add repo and Show archived are in the ⋯ next to "Workspaces"; a repo's scripts are on its right-click menu.
- The "Needs you" list no longer repeats rows: a workspace that needs you gets a gold dot where it is. ⌘⌥L still jumps to the next one.
- The bottom of the sidebar is you, Archived and Settings. Memory use is in the tooltip on your name.
- The workspace header is a breadcrumb (repo › branch), the PR's state and its one main button, and a ⋯ menu. Run, Ports, Compare, Open in, Rename, Rename branch and the rest are in ⋯ and ⌘K; their shortcuts are unchanged. While the run script is live, a Stop button shows.
- One row of tabs: your chats on the left, Changes, Terminal, Preview and Checks on the right. Click a chat to go back to it. The separate PR bar is gone; it is part of the header now.
- The message box shows only what you use every time: the model and effort, and a round Send. Attach, Save as prompt, commands and permissions are in its + menu; pasting or dropping a screenshot still attaches it, and /plan and /auto still switch modes. A small chip shows the mode only when it isn't Auto-accept edits, and the context ring shows once the chat is 70% full.
- The PR's author, lines changed, comments and reviewers are in the tooltip on its number, so the header keeps only its state, CI and the main button.
- Settings ends with the version, What's new, Check for updates and Done. Sponsor and Buy me a coffee moved to General, under Support NekoTrail.
- Workspaces are no longer named after a pasted screenshot or a timestamp ("2026-11-05 at 5.42.16 PM.png"). The title comes from the words of your first message, or the branch name when there are none; existing ones are fixed on the next launch.
Install
Download the .dmg below, open it and drag NekoTrail to Applications. The app is not notarized yet, so macOS blocks it on first launch. Run xattr -dr com.apple.quarantine /Applications/nekotrail.app once in Terminal, then open it as usual.
Linux (experimental)
x86_64 only. Debian or Ubuntu: download the .deb and run sudo apt install ./nekotrail_*_amd64.deb. Other distros: download the .AppImage, make it executable (chmod +x) and run it. Both update themselves from inside the app.