claudeers.
// MCP Servers

meraline

Ask AI anything from ⌥ Space in any Mac app, then let it go. Apple Intelligence, API keys, Ollama, Claude Code, Codex. Chats stay in memory only.

// MCP Servers[ cli ][ api ][ web ][ claude ]#claude#ai#apple-intelligence#chatgpt#claude-code#codex#foundation-models#liquid-glass#mcp-servers◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
98/100
last commit about 1 month ago
last release about 1 month ago
releases 16
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up meraline (release-binary project) into my current project.
Found on https://claudeers.com/meraline
Repo: https://github.com/Meldiron/meraline
Homepage/docs: https://github.com/Meldiron/meraline/releases/latest
Detected install method: release-binary → inspect the README
Category: mcp-servers. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/Meldiron/meraline/releases
// or clone
git clone https://github.com/Meldiron/meraline

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageSwift

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Meraline app icon: a smiling sparkle

Meraline

Ask AI anything, right where you are. Then let it go.


macOS 26 or later · What's new


Meraline is a tiny Mac app for quick questions. Press ⌥ Space, type, and the answer streams in a small glass window. Ask a follow-up if you need one. Click away and it waits for you; press Esc to start fresh. Half an hour after the last message, the chat is gone and the next question starts fresh.

There are no chat lists to manage, no saved history, and no projects. Nothing is saved to disk. Pin the window (📌 or ⌘ P) to keep it open while you work in other apps.

Meraline's floating glass panel: a question about selected text, quoted above it, and the streamed answer, with the buttons for selected text, the clipboard, and a screenshot above the window, the LLM and Agent toggle, the games controller, and the recent chats clock under the input, Copy Answer and Actions in the footer, and the time the chat has left under the window

What it does

✨ Opens anywhere. A global shortcut brings up the window over whatever you're doing, on any Space or full-screen app. It doesn't steal focus from the app you're in, and it closes only when you click or type elsewhere, not when another app takes the keyboard on its own.

💬 Answers quickly. Replies stream in as they're written, with headings, lists, tables, and links rendered, and code in a box with a Copy button. A path to a file or folder on your Mac becomes a link too: click it to open it, or ⌘-click to show it in Finder. While a model searches the web or runs a tool, you see what it's doing, and once it's done, a click on a tool under the answer has the agent say why it used it. While it thinks, Meraline murmurs ("sharpening pencils…", "asking the void…", "consulting the sparkle council…"). Under a finished answer wait two or three questions you might ask next, suggested on your Mac: click one to put it in the input and change it, or Shift-click to ask it right away.

✂️ Knows what you selected. Select text in any app and press ⌥ Space, then click the text cursor above the window: the text comes along as context, so "summarize this" or "what does this mean?" is all you type. It never joins a question until you add it, and texts from several apps can go together. Select files or folders in Finder instead and they're attached: photos for any model, anything for an agent. It needs Accessibility access, which Meraline asks for. Services › Ask Meraline works without it, and takes a picture selected in Preview or Photos too. So does dragging: drop a selection from any app onto the window, and it waits above your question the same way.

⚡ Keeps your everyday asks a click away. The presets above the window's right put a prompt in the input: Fix Grammar, Anti-Slop, Anonymize, and Translate, or your own from Settings › Prompt, where you drag them into the order you like and find each an icon by typing a word, such as mail or urgent. With text selected or copied, one click asks. With none, the click puts the preset in the input and opens the Context card under it, with the cursor already there: paste the text and click the preset again. Shift-click never sends: it puts the preset in the input to add to, and in Decision mode it turns on Live with that preset and puts the cursor in the Context card; Shift-click it again and it stops, closing an empty card and putting the cursor back in the input. A question of your own that ends in a colon, "Fix the grammar:", opens the same card for its text. They're for starting a chat, so they step aside once it starts, and once an answer is ready, ⌘1 to ⌘9 run them on it. Each mode has presets of its own: agents start with Find Bugs, Explain Code, Write Tests, and Research, and decisions with questions.

⚖️ Decides. Switch to Decision (⌘ 3), add the text you selected or copied, or write it in the window, and ask: "Is this urgent?", "Is this a scam?", "Which team should handle this? Billing / Technical / Sales", or "How high a priority is this? Low < Medium < High" for levels in order. The text is optional: a question that stands on its own, like "Is 17 prime?", is decided as it is. TypeSafe's Jev, a model that decides rather than writes, answers in a fraction of a second with a check on green glass or a cross on red, ringed by how sure it is, "82% confident" beside it, and every answer's probability under it. Answers you named get a check tinted by how sure Jev is, amber to green, and levels in order show on a scale with a marker where Jev placed the text. When it isn't sure enough, it says so, and which way it leans; you set the line in Settings › Prompt. The capsule under the input shows the answers the next question picks from; click it, or press ⇧ ⌘ A, to switch between Yes / No and lists of your own, and add, edit (⌘ E), and remove (⌘ ⌫) them there, each a set to pick one from with / between its answers or levels in order with <, explained in the form that writes them. Follow-ups ask about the same text. A switch under the input decides about the whole text, each word, or each line, and groups the words or lines by answer, surest first, each answer folded to its count until you click it: paste a list of tasks and ask "Is this urgent?". The circle at the end of the presets asks every one of them at once, Urgent?, Scam?, Tone, and Priority in one request, each answer on one card. Turn on Live on the Context card, and the card decides as you type, after each pause and once a second while you keep going, without sending: the question in the input and any presets you turn on (Urgent?, Tone, Priority, at once in one request) each show their answer on a glass capsule under the text, a check on green or a cross on red with how sure the model is, the last answer staying until the next lands while Live spins, so a draft reads as ready to send before you press Return. Click the plus on your question to keep it and ask the next, as many as you like; a new chat starts with Live off. Click Improve beside Live, and the LLM you use changes what you wrote toward the answers: Yes on each question, the highest level of a scale, or the answer a list of your own already gives. It starts with small edits that keep your words and length, and once those stop making the answers surer, a click more rewrites the parts in the way, then the whole text if that is what it takes, so you are never told there is nothing to improve while the answer sits at 65%; a note under the capsules says what it did and how much changed, and Undo puts the text back. Press Esc out of habit and nothing is lost: while Live is on, or the Context card has text, what you typed, your kept questions, and their answers wait in Recent Chats, and reopening them brings Live back as it was. With no chat open, ⌘N clears the input and the card the same way, the card's text stashed first.

✍️ Puts the answer to work. Actions (⌘ K) under an answer make it shorter, longer, simpler, more concrete, or a bullet list, in place, so the next rewrite or follow-up builds on what you see, and Undo Rewrite brings back the answer a rewrite replaced. ⌘ ↩ closes the window and pastes the answer at the cursor of the app you were in, formatted where the app takes rich text: select a paragraph, ask for it friendlier, press ⌘ ↩, and the new text replaces the old. Ask to fix the grammar of text you selected or copied, and Show What Changed (⌘ D) under the answer shows your text with each word it took out struck through in red and each it put in green, so a fix is quick to check before you paste it, with how much changed beside the button (“5% changed · 6 edits”); Show Answer goes back. ⌘ T tears the answer off into a small floating note that stays on screen while you follow it in another app; tear off more and they pile up in it, with a count badge that flips through them without opening the window.

🖼️ Understands images and files. Paste a screenshot or drop an image into the window and ask about it, or use the two buttons above the window: one adds whatever you copied, the other a screenshot of your screen without Meraline in it. Agents take PDFs, spreadsheets, and any other file too, and whole folders: drop a project and ask about it, and the agent works on a copy of it, never on your own. When an agent makes a file for you, it hands it over: the file shows under the answer, ready to open in its app, show in Finder, copy, save to Downloads, or drag anywhere.

🎲 Plays word games. The controller under the input opens eight quick games against the model: Rhyme Duel, Add-a-Word, Categories, Word Football, Odd One Out, Fix the Typo, Speed Definitions, and Longest Word. Open a round yourself or leave it to the model or the dice, a move that breaks the rules comes back to you instead of costing a turn, and Esc forgets the game like any other chat. When a round ends, Play Again and your tally against the model stay close at hand until you quit.

🍎 Works out of the box. On a Mac with Apple Intelligence, the on-device model built into macOS answers the moment you install. No key, no account, and nothing leaves your Mac.

🔌 Uses the AI you already have. The toggle under the input switches between asking an LLM, asking an agent, and asking for a decision (⌘ 1, ⌘ 2, and ⌘ 3). Click the sparkle to pick among that mode's providers you've turned on. The clock under the input keeps the chats you close, with their count on it, until each one's 30 minutes run out. To forget them sooner, clear them from the clock, or shake the window while you drag it.

Works with
On this MacApple Intelligence, the on-device model in macOS 26
API keysAnthropic, OpenAI, Google Gemini, OpenRouter
Local modelsOllama, LM Studio, or any OpenAI-compatible server
Command-line agentsClaude Code, Codex, OpenCode, using the account they're signed in to and the MCP servers set up in them
Decision modelsTypeSafe's Jev, directly or through OpenRouter, the other System One models OpenRouter serves (Liquid's D1, Upstage's Solar Decide, …), and, on this Mac, Bespoke Labs' Nimble or Together's Tev1 through Ollama, or Winnow, Jared Palmer's Kev, Laya, and Decider through Ollaya, which answer yes or no, one of your answers, or a level, with how sure they are

🔒 Stays private. API keys live in your Keychain. Conversations exist only in memory. OpenAI requests ask not to be stored, and command-line agents run in an empty temporary folder without saving a session. For a question you'd rather not see again, anonymous mode (⇧ ⌘ N) turns the sparkle graphite, in sunglasses, and keeps chats out of Recent Chats. When you do want to keep something, copy the answer, as Markdown with formatted text beside it for apps that take it, or the whole conversation as Markdown.

📊 Shows what you've used. Settings › Usage counts how Meraline is used, by the hour, day, week, month, and year: questions and answers, tokens in and out with a chart, what they cost at OpenRouter's public prices or as Claude Code, OpenCode, and OpenRouter report it, which models and games, what the agents did, how many decisions and how many weren't sure, what went with your questions, and habits like your busiest hour and longest streak, for every kind of model or only the LLMs, the agents, or the decision models, a click on their tiles away. Numbers only, kept on your Mac, never a word of what was said. Before a chat starts, capsules under the window say what LLMs, agents, and decision models have cost today.

⚙️ Feels at home on a Mac. Settings look like System Settings, the icon follows light and dark mode, and updates install themselves. Settings › Prompt holds every instruction Meraline sends: pick the language answers and games are in (English, Czech, Slovak, and 22 more), give LLMs and agents instructions of their own, rewrite a game's rules, or change what Improve asks for.

Agent mode: Claude Code's answer with a trail of the MCP tools it used and a card asking to write notes.md, with Deny and Allow and its one-line reason from Why? Agent mode: Claude Code asks which release a changelog entry is for, with two choices wearing ⌘1 and ⌘2 and a field for another answer
Agents show the MCP tools they use, ask before writing to the chat's workspace, and say whyAn agent's questions come with their choices
Odd One Out: the model set three words, shown as buttons to tap The recent chats in a panel under the clock beside the games, with Clear Recent Chats at the bottom and a search field
Eight word games unfold from the controller, one click eachThe clock keeps your recent chats, to reopen or clear
Longest Word: nine letters in glass bubbles with a shuffle button, while the model's word stays hidden until you play yours Rhyme Duel waiting for its first move: a card that explains the duel, with a Random Rhyme button to let the model open
Longest Word: your Mac deals the letters and checks both wordsMake the first move, or leave it to the model
The chat's actions over an answer: Insert Answer into TextEdit, Copy Conversation, Tear Off Answer, Ask Again, Ask Again with Apple Intelligence, and the rewrites Make Shorter, Make Longer, and Make Simpler
Rewrite an answer in place, or paste it where you were
Decision mode: asked whether a message selected in Mail is urgent, Jev answers Yes, a check on green glass ringed by its confidence, 82% confident, with Yes 91% and No 9% under it Decision mode: a message from Slack placed along Low, Medium, and High as a high priority, and under the input the answers the next question picks from: Now, After lunch, Tomorrow
Decision mode: Jev answers yes or no, with how sure it isName your own answers after the question, or levels in order
Decision mode about each line: six tasks from Notes under Yes, No, and Not sure, Yes open with its three tasks and how sure Jev is of each, the others folded to their counts, and the switch under the input set to each line Decision mode with Live on: a draft on the Context card, and under it glass capsules for a question kept from the input, answered No on red, the question in the input and Urgent?, answered Yes on green, Tone and Priority on plain glass, and Scam? turned off
Or decide about each word or line, and read them grouped by answerTurn on Live, and the judges answer under your text while you type
Decision mode: every preset asked at once about a message from Mail, each on one row with a check or a cross ringed by its confidence: Urgent? Yes 72%, Scam? No 92%, Tone Neutral 70%, and Priority High 55% Decision mode with Live on, after a click on Improve: the edited text on the Context card, Improve beside the Live switch, the capsules under it answered Yes 86% and Yes 92% on green and High 86%, and under them Improved: 19% changed · 8 edits, with Undo
The circle at the presets' end asks every one of them at onceImprove edits your text toward the answers it should get, and Undo puts it back
The answers' panel open over the capsule under the input: Yes / No, Billing / Technical / Sales, and Low < Medium < High, the levels in use checked with Edit and Remove beside them, and New Answers… under them
The answers under the input open a panel: switch between Yes / No and lists of your own, or write one
An answer with its commands in code boxes with a Copy button, and the same answer torn off into a floating note beside the window
Code comes in a box with a Copy button; tear an answer off into a note that stays on screen
Claude Code hands over the app icon, shown as a picture, and a Markdown note, each with Open, Show in Finder, Copy, and Save to Downloads Settings › Permissions: Accessibility and Screen Recording, what each one turns on, and whether macOS allows it
Agents hand over the files they make, ready to open, copy, or saveEvery permission in one place, with what it's for
Settings › Usage over the last 30 days: a tile each for LLMs, agents, and decisions with what it cost, all three counted, then questions, answers, tokens in and out, cost, and rounds Settings on the Claude Code page: model, reasoning effort, web search, MCP servers turned on, and the list of MCP servers with a toggle each
Settings › Usage counts what you asked, played, and spent, numbers only, for every kind of model or one aloneSettings look like System Settings; each agent lists its MCP servers with a switch for each
Settings › Prompt: the LLM presets as rows, Fix Grammar, Anti-Slop, Anonymize, Translate, and Explain Simply, each with its icon, the start of its text, Edit…, and a handle to drag it by A preset's sheet with its icon search open: urgent typed, and 41 icons found, warning signs, exclamation marks, and bells, the first one chosen
Your presets in a list: drag one into place, or open it to change its textType a word, such as urgent, and pick an icon among every SF Symbol on your Mac

Getting started

With Homebrew:

brew install --cask meldiron/tap/meraline

Or download the latest Meraline-<version>.dmg from Releases, open it, and drag Meraline into your Applications folder.

Then open Meraline. A sparkle appears in your menu bar, and the window opens so you can try it. On a Mac with Apple Intelligence turned on, you can ask a question right away. For other models, click the gear button (or press ⌘ ,) and connect a provider: paste an API key, or turn on Ollama, Ollaya, Claude Code, Codex, or OpenCode.

That's it. Press ⌥ Space whenever you have a question.

The window's glass is the system's: on macOS 27, the Liquid Glass slider in System Settings › Appearance makes it clearer or more opaque, and there is nothing to set in Meraline.

[!TIP] ChatGPT, Gemini, Copilot, and Raycast also use ⌥ Space by default, and macOS quietly gives the shortcut to whichever app grabbed it last. The first time Meraline opens, it checks for them and offers another shortcut, such as ⌥ ⇧ Space, to try before you keep it. If Meraline doesn't open later, pick another in Settings › General.

Keyboard shortcuts

ShortcutWhat it does
⌥ SpaceOpen or close Meraline (change it in Settings)
↩Send
⇥Write a piece of context by hand to send with the question, with the cursor in the card, and go back to the input from it, which takes an empty card away; ⌘ ↩ sends from it
⌫ in an empty inputTake out the selected text, then the last attachment
⇧ ⌘ EAdd the text you had selected when you opened the window, or take it out again
⇧ ⌘ VAdd what's on the clipboard, or take it out again
⇧ ⌘ SAdd a screenshot of the screen, without Meraline, or take it out again
EscStop the answer, then start a new chat, then close the window
⌘ PPin or unpin the window
⌘ KActions for the chat: search them, pick one with the arrows and ↩ (the sparkle's panel when no chat is open)
⇧ ⌘ CCopy the last answer
⌘ DShow what the last answer changed in the text you asked about, or the answer again
⌘ ↩Close the window and paste the last answer into the app you were in
⌥ ⇧ ⌘ CCopy the whole conversation as Markdown
⌘ TTear the last answer off into a floating note
⌃ ⇥, ⌃ ⇧ ⇥In a torn-off note, the next answer on its pile, or the one before (⇧ ⌘ ] and ⇧ ⌘ [ too)
⌘ +, ⌘ −, ⌘ 0Make answers larger for reading across the room, smaller, or their own size again; pinching on the trackpad zooms too, in the window or a torn-off note
⌘ RAsk the last question again; in a game, restart it, or play again once a round is over
⌘ IShow a hint in a game
⌘ 1, ⌘ 2, or ⌘ 3Ask an LLM, an agent, or for a decision, by the key's place on any keyboard layout
⌘ 1 to ⌘ 9Once an answer is ready, run the first to ninth preset on it; while an agent asks a question with choices, pick one
⇧ ⌘ AIn Decision mode, open the answers the next question picks from: Yes / No or a list of your own, with ⌘ E and ⌘ ⌫ to edit or remove one
⌘ NStart a new chat; with no chat open, clear the input and the Context card, the card's text stashed in Recent Chats first
⇧ ⌘ ⌫Delete the chat, after asking; it skips Recent Chats
⇧ ⌘ OShow an agent's files in Finder
⌘ OOpen the file an agent handed over
⌘ SSave the files an agent handed over to Downloads
⌘ S with no chat openStash what you typed, and what you added, in Recent Chats to reopen within 30 minutes
⇧ ⌘ NTurn anonymous mode on or off
⌘ ,Open Settings

Privacy, and how to check it

Meraline is built so you don't have to take its word for any of this.

  • No account and no server in between. Questions go straight from your Mac to the provider you chose. Meraline has no backend, no analytics, and no crash reporting. The only other connections are an update check against github.com every 15 minutes, which you can turn off in Settings, and the pictures in a release's notes, fetched from GitHub when you open What's New. Watch the traffic with any network monitor and you'll see nothing else.

  • Nothing on disk. Conversations and games live in memory and are gone when you quit. The preferences file (defaults read com.meldiron.meraline) holds settings only: shortcut, window placement, which providers are on, and the prompts you changed. The one other file, ~/Library/Application Support/Meraline/usage.json, holds the counts Settings › Usage shows: how many questions, answers, tokens, and games in each five-minute slot, by kind of model, provider, model, and game. Open it and you'll find numbers and names of models and games, never a word of what was asked or answered; Clear Usage Data deletes it.

  • Chats last 30 minutes. Each chat is deleted from memory, with the folder its agent worked in, 30 minutes after its last message, in the window or in Recent Chats. The capsule under the window's bottom right counts down, turning pink in the last 5 minutes; click +5 min or +30 min beside it to give the chat more time, which your next message won't take away. Start a new chat (⌘ N or Esc) and the last one goes to Recent Chats with the time it has left, which reopening it doesn't change, or is forgotten if it was anonymous. A draft you stash (⌘ S) waits there for 30 minutes too.

  • Gone when you step away, if you want. Turn on Forget chats when the Mac sleeps or Forget chats when the screen locks in Settings › General and every chat goes at that moment: the one in the window and what's typed in it, Recent Chats, torn-off answers, and the folders agents worked in. The first counts the display turning off too, the second switching to another user. Both are off unless you turn them on; quitting, restarting, shutting down, and logging out always forget your chats.

  • Keys in the Keychain. API keys are stored as Keychain items under the service com.meldiron.meraline.api-keys, where Keychain Access can show and delete them. They never appear in preferences, logs, or diagnostics.

  • Command-line agents stay in charge of their own sign-in. Meraline runs the unmodified claude, codex, and opencode commands with session persistence off. It never reads or copies their tokens. The MCP servers set up in an agent are available to it here too, as the agent reports them; Settings › Agents lists them and lets you turn any of them off for Meraline alone, without touching the agent's own configuration. Each chat gives its agent a scratch folder in the temporary directory, holding only copies of the files and folders you attach, never your originals, and what the agent writes there. It is removed when the chat's time runs out, the chat is forgotten, or Meraline quits, and it takes in at most 20,000 files and folders. A file the agent hands you stays in that folder until you copy or save it, and it's marked as downloaded before it leaves for another app, so macOS checks any app or program in it before it first runs. Open never runs anything: scripts open as text, and apps are only shown in Finder. When Claude Code wants to write there, or has a question of its own, Meraline shows it and waits for you; Why? has it say in one line why it wants to.

  • Paths become links, nothing more. A path in an answer turns into a link only if it names a file or folder on your Mac, checked when the answer is shown and remembered nowhere, and paths on network servers are never checked. A click opens it the way a file an agent hands you opens: apps are only shown in Finder, and scripts open as text.

  • The selection is read only when you ask. With Accessibility access, Meraline reads the selected text of the app in front, or which files are selected in Finder, when you press the shortcut, and at no other time. The text stays in memory, out of your question, unless you click the text cursor to add it. It skips password fields and secure input. When an app doesn't share its selection directly, Meraline presses that app's Copy command (or ⌘C, in an app like Zed that describes nothing but its window) and puts back what was on your clipboard straight away. Turn it off in Settings › General.

  • Screenshots only when you click. The screen button takes a single picture of the display the window is on, with Meraline's own windows left out, and attaches it to your next question. It needs Screen Recording access, which macOS asks you for, but Meraline never records: nothing is captured until you click, and the picture lives in memory with the chat. The clipboard button reads your clipboard only when you click it; while the window is open, Meraline only checks what kind of thing is on it, to show whether there's something to add. Passwords that password managers mark as concealed are never read.

  • Your clicks and keys are timed, never read. To tell a click elsewhere from an app that took the keyboard by itself, Meraline asks macOS how long ago the last click or key press was when the window loses the keyboard, and nothing more: not which key, not where.

  • Every access in one list. Settings › Permissions shows Accessibility and Screen Recording, the features each one turns on, and whether macOS allows it right now, with a button to ask for it and one that opens its page in System Settings.

  • Off screen shares, if you want. Hide from Screen Sharing, in the sparkle's panel or Settings › General, asks macOS to leave the window out of screen sharing, recordings, and screenshots. It's off unless you turn it on. Apps that capture the whole display, such as QuickTime, can still show the window, so try it with yours first.

  • Decisions go to TypeSafe or OpenRouter, and only when you ask. In Decision mode, the text you added and your question go to api.typesafe.ai, or to openrouter.ai when OpenRouter is your decision provider, as one request, with your key in a header, when you press Return, click a preset with the text there, or click the circle at the presets' end that asks every one of them, or, with Live turned on on the Context card, after each pause in typing there, and at no other time. With no text added, only the question goes. No picture or file ever goes, and the reply, a few numbers, lives in memory with the chat. TypeSafe's policy is not to train on customer data; through OpenRouter, your account's data policy applies, as for its LLMs. With Ollama or Ollaya as your decision provider, the request goes to it on this Mac and nothing leaves it. Settings › Usage counts decisions, never their answers. Improve on the Context card sends the text, the questions, and their answers to the LLM you use, as a question of yours would, only when you click it.

  • On-device means on-device. Apple Intelligence answers come from the model inside macOS, and Ollama's from a model on your Mac. Nothing is sent anywhere, unless you pick one of Ollama's cloud models or point it at another machine. The follow-up questions under an answer are suggested on your Mac too, by Apple Intelligence when it's on, and never by your provider; they stay in memory and go when you ask the next question.

  • It's all open source. Search the code for URLSession, Process, and Keychain to see every place Meraline talks to anything.

Automate it

Other apps and scripts can open Meraline through the meraline:// URL scheme, which makes it easy to wire up in Shortcuts, Raycast, or a shell alias:

URLWhat it does
meraline://ask?text=…Opens the window with the question filled in
meraline://ask?text=…&send=1Fills it in and sends it
meraline://ask?selection=…Opens the window with text to ask about, as if you had selected it; add text= and send=1 to ask right away
meraline://ask?clipboard=1Adds what's on the clipboard, as the clipboard button does
meraline://ask?screen=1Adds a screenshot of the screen the window opens on, as the screen button does. With send=1, the question waits for it, and isn't sent if it can't be taken
meraline://ask?agent=1Asks an agent; agent=0 asks an LLM. Works with everything above
meraline://ask?mode=decisionAsks for a decision; mode=llm and mode=agent work too. Works with everything above
meraline://ask?mode=decision&scope=linesDecides about each line; scope=words about each word, scope=whole about the whole text
meraline://newStarts a new chat and opens the window
meraline://playOpens the window with the games showing
meraline://play?game=oddOneOutStarts a game: rhymeDuel, addAWord, categories, wordFootball, oddOneOut, fixTheTypo, speedDefinitions, or longestWord. Its title works too, as in odd-one-out
meraline://mode?agent=1Switches to Agent and opens the window; agent=0 switches to LLM, mode=decision (or mode=llm, mode=agent) to that mode, and meraline://mode alone to the next one around the toggle
meraline://settingsOpens Settings
meraline://settings?pane=claudeCodeOpens Settings on a page: general, prompt, permissions, usage, updates, about, or a provider such as anthropic, apple, codex, or typeSafe

A meraline:// link in an answer works with a click too, but never sends: the question it fills in waits for you to press Return.

open "meraline://ask?text=$(python3 -c 'import urllib.parse,sys; print(urllib.parse.quote(sys.argv[1]))' 'Explain CRDTs in one paragraph')&send=1"
open "meraline://ask?text=What%27s%20wrong%20here%3F&screen=1&clipboard=1&send=1"

Updates and beta builds

Meraline checks for updates every 15 minutes, and again when you open the window after the Mac slept through a check, and installs them quietly in the background; a capsule under the window, the menu bar menu, and Settings › Software Update show when one is ready. To try builds before they are released, turn on Settings › Software Update › Get beta updates. The chip at the top of that pane says whether the copy you run is a stable build or a beta, with the tag of its GitHub release, and opens that release. After an update, a What's New capsule under the window opens the release notes, pictures included.

Something off? Copy Diagnostics, in the sparkle's panel or Settings › About, gives you a report to paste into a bug report, whenever you like. It has no keys, questions, or answers in it, and your home folder is written as ~. If Meraline ever quits unexpectedly, the next time you open the window it offers the same report, with where it crashed, once.

Build it yourself

You'll need Xcode 26 and XcodeGen. No Apple Developer account is needed to build and run.

brew install xcodegen
git clone https://github.com/Meldiron/meraline.git
cd meraline
scripts/dev_run.sh     # build and launch
scripts/test.sh        # run the tests (add --e2e to also run the installed command-line agents)

xcodegen generate followed by open Meraline.xcodeproj gets you into Xcode. CONTRIBUTING.md has the rest; Meraline is MIT licensed.

For maintainers

Every push to main and every pull request runs the tests in GitHub Actions and builds a preview of the installer, attached to the run as an artifact.

To ship a new version, push a tag:

git tag v1.0.1
git push origin v1.0.1

The Release workflow runs scripts/release.sh: it builds the app with the tag's version, signs it with the Developer ID certificate, notarizes and staples it, wraps it in a styled disk image that is signed and notarized in its own right, signs the update for Sparkle, and publishes a GitHub release with the .dmg, the .zip, appcast.xml, debug symbols, and checksums. Installed copies check https://github.com/Meldiron/meraline/releases/latest/download/appcast.xml for updates every 15 minutes, and when the window opens after longer.

Release notes come from CHANGELOG.md when the version has an entry there, and from the commits since the previous tag otherwise.

docs/releasing.md covers the pipeline step by step, the disk image design and how to edit it, running a release on your own Mac, and the secrets the workflow needs.

// faq

What is meraline?

Ask AI anything from ⌥ Space in any Mac app, then let it go. Apple Intelligence, API keys, Ollama, Claude Code, Codex. Chats stay in memory only.. It is open-source on GitHub.

Is meraline free to use?

meraline is open-source under the MIT license, so it is free to use.

What category does meraline belong to?

meraline is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

14 views
★ 11 stars
unclaimed
updated about 1 month ago

// embed badge

meraline on Claudeers
[![Claudeers](https://claudeers.com/api/badge/meraline.svg)](https://claudeers.com/meraline)

// retro hit counter

meraline hit counter
[![Hits](https://claudeers.com/api/counter/meraline.svg)](https://claudeers.com/meraline)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how meraline connects across the ecosystem