ShellMate
ShellMate is an open-source macOS Terminal companion powered by OpenAI. It answers plain-English questions, detects and fixes command errors from your shell history, and inserts AI-generated suggestions straight into your active console. Development stopped in December 2024.
What is ShellMate?
ShellMate is a macOS Terminal companion built by Camels & Needles Corporation and published under the Deepspring.ai brand. It sits beside the Terminal rather than replacing it, and its stated purpose is to keep a developer inside the shell instead of switching to a browser or a chat window every time a command fails or a flag slips the mind.
The tool accepts prompts from three places: standard input, command-line arguments, and text highlighted in the Terminal window. The headline interaction is the sm shortcut — typing something like sm "find a file?" sends the question off and drops the generated command straight into the active console, ready to run or edit. Highlighting a block of output before asking narrows the model's attention to that specific error or passage, which is the difference between a generic answer and one that addresses what is actually on screen.
Beyond answering direct questions, ShellMate reads the terminal history to detect failed commands, propose corrections and anticipate what is likely to come next. The publisher describes this as dynamic error correction and guidance delivered seamlessly, keeping the user in the Terminal and in the flow.
The application is native macOS software written in Swift and built as an Xcode project; the repository also ships a ShellMateCLI component alongside the main app. It is released under the MIT licence, and the public repository carries 260 commits, 135 stars, 9 forks and 15 open issues. Intelligence comes from OpenAI, and one operational detail matters more than any feature list: the bundled free-tier API key has been deleted, so every user must supply their own OpenAI key, either through the application's settings and permissions view or by editing a hard-coded value in the source.
Two caveats weigh heavily. Development has stopped — the last commit landed in December 2024 and no release has ever been published. More consequentially, the official website no longer serves the product: as of August 2026 the domain redirects to an unrelated project, so the DMG that once sat behind an email form is gone and building from source is the only remaining route in.
What it does
- Answer a question typed in plain English without leaving the Terminal
- Spot a failed command and propose the corrected version
- Predict the command you are likely to need next from your shell history
- Insert the generated suggestion directly into the active console
- Focus on a highlighted block of text to narrow the question
- Take prompts from standard input, command-line arguments or a selection
- Remove the round trip to a browser tab or a separate chat window
When to use ShellMate / When not to
A quick filter to help you decide if ShellMate is the right fit.
When to use ShellMate
- Developers and engineers who spend their working day inside the macOS Terminal
- System administrators and DevOps engineers who hit cryptic command-line errors
- Anyone who knows what they want to do but never remembers the exact flag or syntax
- Mac users comfortable with Xcode who can clone a repository and build it themselves
- People who already hold an OpenAI API key and want to spend it on shell assistance
When not to use ShellMate
- Windows and Linux users, since ShellMate is a macOS-only application
- Anyone looking for a mobile app, as no iOS or Android version exists
- Teams that require a privacy policy, terms of service or a DPA before adoption
- Organisations that need an actively maintained vendor with a working download page
- Non-technical users, who now have to compile the app from source to get it at all
How to use ShellMate
A typical end-to-end flow, from setup to results.
- Start from a Mac — ShellMate is a macOS application and runs nowhere else
- Historically, download the DMG from the product page after entering your email address; that channel no longer responds
- In practice today, clone the public repository with git and open it in Xcode
- Build the project in Xcode to produce the application
- Supply your own OpenAI API key through the application's settings or its permissions view
- Alternatively, replace the hard-coded key value at line 16 of ShellMate/Helpers/Utils.swift
- If you build from source, create a Secrets.xcconfig file from the supplied template and add a Sentry authentication token
- If you intend to distribute the app, obtain a Developer ID Application certificate through a Keychain Access signing request
- Launch ShellMate alongside your Terminal window
- Type sm followed by your question, or highlight text first to focus the answer, then accept the suggestion inserted into the console
Pros & Cons
Pros
- Free and open source under the MIT licence, with no subscription or paid tier
- Keeps you in the Terminal instead of forcing a switch to a browser or chat window
- Auditable and forkable: 260 public commits and a permissive licence
- Works from real context by reading terminal history rather than answering cold
- You bring your own OpenAI key, so billing and account control stay with you
- Installable outside the App Store, with no vendor account to create
- Earned genuine public recognition, including Product Hunt top post badges
Cons
- The official site is gone: the domain now redirects to an unrelated product and the DMG cannot be downloaded
- Development has stopped, with the last commit in December 2024 and no release ever published
- macOS only, with no Windows, Linux or mobile version
- An OpenAI API key is mandatory and its usage cost falls entirely on you
- No terms of service, privacy policy, DPA or GDPR statement of any kind
- No support channel: no published email address, only GitHub issues
- It reads terminal history, which routinely contains secrets and sensitive strings
Pricing & Plans
The software is free of charge. It is distributed as open source under the MIT licence, and no pricing page, paid tier or subscription has ever been published, so there is no entry price point to quote. One indirect cost should be anticipated: ShellMate relies on OpenAI, and since the bundled free-tier API key was removed, each user must supply a personal OpenAI key. Consumption is therefore billed directly by OpenAI to that account, at whatever rates apply there.
Data, GDPR & hosting
A consolidated view of how ShellMate handles your data.
GDPR overview
There is no GDPR implementation to report, and that absence is worth stating plainly: the regulation is never mentioned anywhere. The website carried only two pages and neither was a privacy policy, terms of service or legal notice; the project's README does not raise the subject either. A targeted search across the archived pages and the repository returned matches only inside GitHub's own footer, which points to GitHub's policies and not to ShellMate's. There is no designated Article 27 representative, no data protection officer, no GDPR contact address, no stated legal basis for processing, and no documented procedure for access, rectification or erasure requests. The publisher is a United States company with no declared European presence. A European user therefore has no published commitment of any kind to rely on.
Who owns the data?
No terms of service, privacy policy or legal notice has ever been published on the product's website, so there is no contractual statement about who owns your data or what the publisher may do with it. What can be described is the architecture. ShellMate runs locally on your Mac and the publisher operates no server of its own; your prompts and the terminal context around them are sent to OpenAI using an API key that you supply and pay for, which places that traffic under OpenAI's terms rather than the publisher's. Sentry is wired in for error reporting, and the download page collected an email address before handing over the installer.
Reuse rights
Two very different regimes have to be separated here. The source code is released under the MIT licence, which is about as permissive as it gets: you may use, copy, modify, merge, publish, distribute, sublicense and sell the software, including commercially, provided the copyright and licence notice travel with it. Forks are explicitly welcomed and pull requests are invited. Your own data is a different matter: because the publisher never wrote any terms of service, nothing grants or withholds a right of reuse over the content you type or the suggestions you receive. In practice the material stays on your machine and in your OpenAI account, but that is a consequence of the architecture, not a contractual guarantee.
Data retention & training
Hosting summary
No hosting information has ever been published: there is no trust or security page, no privacy policy and no statement of jurisdiction for user data. What can be established comes from the architecture rather than from any commitment. ShellMate executes locally on the user's Mac, and the publisher exposes no service of its own to which conversations could be sent or stored. Prompts and the surrounding terminal context travel to OpenAI's infrastructure, authenticated with an API key belonging to the user, so any retention or regional guarantee is the one OpenAI offers on that account. Sentry receives error reports from the application. The marketing site itself was hosted on Webflow, and the domain today resolves to an anycast address operated within Amazon's network. None of this amounts to a declared hosting jurisdiction for user data, and prospective users should assume none exists.
Things to keep in mind
Risks and trade-offs to weigh before adopting ShellMate.
- ShellMate reads your terminal history, so API keys, tokens, passwords and internal hostnames can be sent to the model along with the context
- No privacy policy exists to tell you what is transmitted, logged or retained, which leaves the whole question open
- Running AI-suggested commands without reading them can destroy data or change a system in ways that are hard to undo
- Leaning on an assistant for commands you once knew erodes the skill over time, and that loss only shows up when the tool is unavailable
- The software has not been maintained since December 2024, so any vulnerability found since then remains unpatched
- With the official download gone, any DMG found elsewhere is of unverified origin and should be treated as untrusted
- Your OpenAI key is stored locally and, if you follow the source-editing route, may end up hard-coded in a file you later commit
Setup & Integrations
Technical difficulty
High as things now stand. With the DMG no longer downloadable, the only route is to clone the repository and compile it in Xcode, which assumes a Mac, a working Xcode installation and a personal OpenAI API key. Building also means creating a Secrets.xcconfig file and supplying a Sentry token, and distributing the result requires an Apple Developer ID certificate. When the installer was still available the experience was straightforward: fill in an email, drag the app across, paste a key.
Deployment
Integrations
Behind ShellMate
Resources
All the official URLs gathered for verification and reference.
Frequently asked questions
Which platforms does ShellMate run on?
How much does ShellMate cost?
Do I need my own OpenAI API key?
How do I install it?
Is the official website still working?
Is the project still maintained?
Is the code open source?
Is there a privacy policy or terms of service?
Does ShellMate offer an API or a mobile app?
How do I get support?
Should you pick ShellMate?
ShellMate had a sharp, well-bounded idea: keep the developer in the Terminal. Rather than building yet another chat window, it wired an assistant into the place where the work already happens, taking prompts from standard input, arguments or a simple text selection, reading shell history for context, and pushing the answer back into the active console through a two-letter shortcut. The execution behind that idea was credible — a native Swift application, a companion CLI, 260 commits, and an MIT licence that lets anyone read and reuse the whole thing. The traction was real if modest: 135 stars, nine forks, and Product Hunt top post badges.
The problem is what happened afterwards. The last commit landed in December 2024, no release was ever published, and fifteen issues sit open. More decisively, the official website has been repurposed: the domain now redirects to an entirely unrelated project, which means the DMG behind the email form — the only route that non-developers ever had — has simply vanished. What survives is the public repository.
That leaves a narrow but genuine audience. A Mac developer who is comfortable cloning a repository, building it in Xcode and plugging in a personal OpenAI key can still get a working assistant out of this, and the permissive licence means the code can be forked and taken further. Anyone else should look elsewhere.
Two further points deserve weight before adopting it. There is no legal documentation whatsoever — no terms, no privacy policy, no GDPR mention — which rules the tool out of most professional and regulated settings. And because it reads terminal history, secrets and sensitive strings can travel to the model. Treat ShellMate as an interesting codebase to inherit rather than a supported product to depend on.
- Choosing a selection results in a full page refresh.
- Opens in a new window.