← All guides

Docs · Setup & everyday use

PromptDeck

PromptDeck builds you tools that remember. Describe what you need — a tracker, a ledger, a CRM — and you get a mini app that runs on your machine and keeps its data between runs. It answers questions about data you already have, in plain English. And it runs one-off prompts when a quick answer is all you want.

Product demo · 1 min 26 s

Watch PromptDeck at work

Recorded in the real PromptDeck 0.4.71 app with a fictional vintage camera shop, its customers and made-up data. The AI is real: the recording machine's ChatGPT plan, through Codex, built the mini apps and made the agent's run. The agent runs on the model you choose in Settings: your Claude or ChatGPT plan, or an API key. The order email came from a test inbox on the recording machine. The agent proposes replies; one goes to your Drafts only when you approve it, and nothing is sent. Waits are cut and typing is sped up. Captions and music, no voiceover.

Set it up

  1. Download and run PromptDeck

    PromptDeck is a portable app — there's no installer. Download it from your purchase email (on Windows that's PromptDeck-0.4.77.exe, about 114 MB) and double-click to run it; the first launch unpacks the app, so set aside roughly 400 MB of space. The download link in the email stays valid for 30 days. Windows may show a SmartScreen prompt the first time — the app is code-signed (publisher: Chris Ross), so choose More info → Run anyway.

  2. Choose how to connect AI

    Already have Claude Pro or Max? Install Claude Code, then choose Claude subscription in PromptDeck. PromptDeck opens Claude Code's sign-in flow and uses your local Claude Code connection, so you don't need an API key or separate API usage. On ChatGPT Plus or Pro? Install OpenAI's Codex (the desktop app or the CLI) and sign in once; PromptDeck finds it and runs on your ChatGPT plan, again with no API key. Prefer other models? An OpenRouter key unlocks hundreds of pay-as-you-go models, or you can connect an Anthropic API key or any OpenAI- or Anthropic-compatible endpoint. There's one more route for teams that already run a LiteLLM gateway — see “One gateway for every model” below.

    Install Claude Code →
  3. Connect on first launch

    Choose Claude subscription to sign in through Claude Code, connect your ChatGPT plan through Codex, or paste an OpenRouter or Anthropic API key. API keys are validated and stored encrypted on your device using the operating system's keychain — never in plain text and never sent anywhere except the selected model provider.

  4. Pick a default model

    In Settings, choose the model new apps start on. Every app can override it later — this is just the default.

Everyday use

Start with a built-in app

Eighteen ready-made apps are included so PromptDeck is useful in the first minute, in two packs on the welcome screen. Small business: Customer Reply Writer, Inbox Triage, Printable Quote, Invoice Tracker, Receipt Reader, Clients & Leads, Booking Scheduler, Inventory Tracker, Weekly Business Digest, Social Post Pack, Review Responder, and Job Ad Writer. Everyday: Mini App Builder, Meeting Notes → Actions, Email Rewriter, Report Analyzer, Draft & Polish, and Translator. Picking one opens its blueprint — what it asks for and what it does — with no model call. Half of them come with a worked example you can try in one click, and some bring starter notes or a suggested automation.

Build your own

  • Press New app (or pick “A new app” on Home) and describe what you want in a sentence or two, then press Design it. PromptDeck drafts the app and shows its blueprint: name, what it does, the fields it will ask for, and an example.
  • Change it in plain words before you keep it — “also ask for a deadline” — and press Update. When it looks right, Create saves it, or Create and try the example saves it and runs it once so you see a real result.
  • Want full control? Customize everything… (or Build it by hand instead) opens the editor:
  • Give the app a name, an icon from the built-in set, and a one-line description.
  • Write the prompt once, and wrap the parts that change in {{double braces}}.
  • Not sure how to word it? Suggest template drafts the instructions and {{blank}}s for you from the app's name and description — then make it yours.
  • Every {{blank}} automatically becomes a labeled field on the run screen: a single line, a paragraph box, a dropdown of fixed choices, a file attachment, or a folder.

Run it

  • Fill in the fields and hit Run app — the answer streams in as it's written.
  • Your runs are saved. Each app has a History dropdown listing past runs, newest first — reopen one to see the full transcript and pick the conversation back up where you left off, even after closing the app. It's all on your machine, and no secrets are written to disk.
  • Ask follow-up questions on any run to keep the conversation going; delete a saved run from the list when you're done with it.
  • Export saves the result to a file when you want to keep it.

Files and folders

  • A file field opens a native picker (drag-and-drop works too) and sends the document with your prompt.
  • A folder field is the power move: the app always runs against the newest file in that folder. Point it at the folder where reports land, and this week's report is always the one analyzed — no re-picking.

Voice notes: speech to text on your computer

Talk instead of typing. Set it up once under Connectors → Speech to text → Set up (730 MB): a one-time download with progress and a Stop button, and if it's interrupted, Try again carries on where it stopped. Once the card says “Ready on this computer”, go to Run inbox, press “Record voice note”, then press the microphone (“Press to record”): your words become text on your own computer, and the recording never leaves it.

  • Read the transcript, edit it if you like, then choose “Open app with transcript” to hand it to one of your apps that takes text.
  • The speech engine starts with your first recording and stops after 10 idle minutes, or when PromptDeck closes. It doesn't need CodonTerminal, and runs alongside it.
  • If setup asks for your update key, add it in Settings → Updates. It's the same key PromptDeck uses for updates, from your purchase email.
  • Speech to text runs NVIDIA's Parakeet TDT 0.6B v2 model on this computer, in the ONNX export and int8 quantization by istupakov (converted from the original), under CC BY 4.0.
The CC BY 4.0 licence →

Chain steps

An app can run as a chain of steps, where each step's output feeds the next. The classic: Draft → Critique → Revise — one click writes a draft, tears it apart, and hands you the improved version.

Mini apps: tools that keep their data

A mini app is an interactive tool that runs sandboxed inside the window and remembers what you put in it between sessions. Five come ready to open — Invoice Tracker (who owes what, due dates, paid status), Printable Quote (line items, tax and totals, printed as a clean customer-facing quote), Clients & Leads (stage, estimated value, and who's overdue a follow-up), Booking Scheduler (appointments, with a warning when two confirmed ones overlap), and Inventory Tracker (stock levels against reorder points). Each starts empty or from data you paste in. For anything they don't cover, ask for a tool instead of an answer — “a job log with equipment and hours”, “a membership register” — and the Mini App Builder makes it; the builder also reaches for this shape on its own whenever the work needs to accumulate.

  • Before you see a new mini app, PromptDeck loads it out of sight and clicks every button. If anything breaks, it asks the model to fix it and keeps the fix only if it tests better, and tells you what it found.
  • Full screen shows the app on its own (Esc leaves it), and an app can put its own work area, like a map or a canvas, full screen.
  • A mini app can ask your AI for things while you use it — the latest price, today's news, a summary — and search the web through it when it needs to. The app itself still can't reach the internet: PromptDeck makes the request with the AI you chose, shows when it's asking, and limits how often an app can ask.
  • Tweak it by describing the change in plain English: “add a column for client email”, or fix the data itself — “change the Acme deal to $700”. Edits to your saved rows are shown as a diff you approve before anything is written.
  • Rework it when you want it to work differently — “lead with a daily log, and adjust my calories from the weekly trend”. The AI proposes a plan first (the screens in order, and what will respond to your data); you edit or approve it, then the app is rebuilt around the data you already have.
  • Ask AI opens a chat beside the app that can see what it has saved: ask “am I on track?” and it answers with your own numbers. When it suggests something, it's a button — a data fix you approve, a tweak, or a rework — and nothing changes until you press it.
  • Every change keeps the version it replaced. Earlier versions, in the ⋯ menu, puts one back; your saved data is never touched.
  • Apps that follow progress — weight, a budget, sales targets — open on the screen you use every day once they're set up, and suggest adjustments from what you've logged.
  • Rebuild from its recipe (in the ⋯ menu) runs the prompt that built the tool again, so a data-backed app regenerates without losing the rows you entered. It replaces your tweaks too, so it asks first — and the old version is kept.
  • Export a mini app as a standalone .html — it opens in any browser with its data baked in and keeps saving locally, with no PromptDeck needed on the other end.
  • Print a mini app, or save it as a PDF, to send to someone — an invoice or a quote goes straight to a customer. Only the app and its data print, not PromptDeck's window.
  • Generated apps have no network access of their own — they can't phone home or reach your other data (enforced by a strict content-security policy and an iframe sandbox); anything live comes through your AI, as above.

Ask questions about data you already have

Not everything needs a tool built around it. Open Ask your data from the sidebar — it's there from any view — point it at some data and ask in plain English. You get a real answer computed from your actual rows, with the exact numbers shown underneath so you can check the working. Nothing is built, and nothing is saved unless you choose to keep it.

  • Load it from wherever it lives: a .csv on your computer, an Excel .xlsx (it asks which sheet), cells pasted straight from Excel or Sheets, a JSON file, a published sheet or a .csv/.json at a web address.
  • Or connect your own database — Supabase, Turso, Neon, D1, Firestore, or a JSON endpoint — under Manage database connections, where you can add, test and remove them. PromptDeck reads from them; it doesn't write back.
  • The kinds of things people ask: which customers spent the most last quarter, what's my average order value by month, which items are below their reorder point, how do this year's bookings compare with last year's.
  • Found something worth keeping? That's when you build the mini app around it — the analyst is the quick look, the mini app is the thing you keep.

Your business on your tools

The tools you keep don't have to look like ours. Click the colour-swatch button in the sidebar footer, next to the settings gear, to open Owner & branding, and fill your business in once: a logo (PNG, JPG, GIF, WebP or SVG, up to 512 KB), your business name, a one-line tagline, and a contact block for the phone number, email, address or tax number you want on paperwork. From then on every mini app carries them as a letterhead across the top — including the tools you built before you set it up.

  • The letterhead is there to be printed. Print a quote or an invoice, or save it as a PDF, and your details go out on it — the customer gets your letterhead rather than a bare table. PromptDeck's own buttons and toolbars still stay off the page.
  • It travels with the file. A mini app exported as a standalone .html keeps the letterhead when it opens in someone else's browser, because the logo is stored inside the file rather than linked to your machine.
  • Choose your accent and secondary colours from eight ready-made colourways — PromptDeck's own terracotta included — or type your own hex codes. New tools are built in your colours from the first draft, and tools you already keep are repainted as they open.
  • Nothing is rewritten on disk to do it. Turn the branding off and every saved tool goes straight back to how it was, so it's safe to try.
  • PromptDeck itself follows suit: your accent on its buttons and highlights, square, default or rounded corners, an interface size from Compact to Largest, and your logo and business name in the title bar in place of ours.
  • Your logo is read from disk once and kept with your settings on your machine, stored inside the app so a printout or an export can still show it. It isn't uploaded anywhere and it never goes to the model — when a new tool is being built, the model is told your colours, your business name and your tagline so it can lay the page out around them, and nothing else.

The totals dashboard

The apps you keep roll up into Totals tiles on the dashboard — record counts and per-field sums, worked out on your own machine with no model call and no network. Rate, percent, and score fields are averaged rather than summed. The tiles follow your selection: nothing open shows totals across everything, click an app and they narrow to just it.

  • Tell it what to track in the same “change it” box: drop a tile you don't care about, or add one the automatic view can't guess — “track the highest performer” groups your records by a dimension (say, per salesperson) and surfaces the winner.
  • Export any table to CSV for Excel (UTF-8, so accents survive), or copy it as TSV to paste straight into a spreadsheet. Cells that start with =, +, or @ are neutralized so a spreadsheet won't run them as formulas.

Your workspace home

Home is where the day starts. Your apps sit in one row, ready to open where you left off. The box under them hands any app something to work with — a draft, a note, a pasted table — and you review it in that app before anything runs. A count at the top shows anything waiting on you.

Automations: an app on a schedule

Automations run one of your saved apps without you pressing Run, exactly as it runs by hand — same model, same knowledge, same steps. Open Automations, choose the app, then choose when.

  • At a time: a time of day on the days you pick, like every Monday at 8:00.
  • Every so often: every few minutes or hours (never more often than every five minutes).
  • When a file arrives: point it at a folder, and the newest file that lands there becomes the input — a weekly report, an export, a scan.
  • Tick “Ask me before it runs” for anything you want to see first. The trigger then waits in the Run inbox instead of running, and approving runs it once; the next time it asks again.
  • Automations run on this computer only, while PromptDeck is open. If it was closed through a scheduled time, the app runs once when it's back — not once for every time it missed.

The Run inbox

The Run inbox is everything your apps did, are doing, or need you to decide: automation runs, the agent's runs and the replies it proposes, voice notes and runs you started yourself. Filter it to what needs you, open any result as its real saved run, and approve or decline anything that's waiting. If you've connected local speech in Connectors, Record voice note turns what you say into text you review before sending it to an app.

Email: read new mail, send only when you press Send

Open Connectors and find Email. Outlook, Hotmail and Microsoft 365 sign in with Microsoft in your browser, and PromptDeck never sees your password. Gmail connects with an app password you create at Google. Either way it is kept encrypted on this computer and goes only to Microsoft or Google. Nothing is ever sent unless you press Send.

  • Outlook, Hotmail and Microsoft 365: read and send. New mail in the inbox can start an automation, and you can reply with a result.
  • Gmail: read new mail and save replies as drafts. Turn on 2-Step Verification for your Google account, create an app password at Google (it is 16 letters), then press Connect Gmail and paste it with your address. New mail can start an automation, and a reply is saved to your own Gmail Drafts, in the same conversation, for you to check and send from Gmail. PromptDeck never sends from Gmail.
  • Sending from a Gmail address is not open to everyone yet, because Google has not approved PromptDeck for it. To email a result, use an Outlook, Hotmail or Microsoft 365 account.
  • If your Google account will not give you an app password (some work and school accounts do not), Gmail can still reach PromptDeck through Google Drive. Label an email “PromptDeck” in Gmail and a script saves it as a text file in the Drive folder “PromptDeck Inbox”. Google Drive for desktop brings that folder to your computer, and a “When a file arrives” automation runs an app on each one. Other ways to bring Gmail in, under the Gmail card, walks you through it. The script runs in your own Google account, not on our servers.
  • To run an app on new mail, create an automation and choose “When an email arrives”. You can limit it to mail whose sender or subject contains some text, and Only emails from people skips newsletters, receipts, codes and other automatic mail. The inbox is checked about once a minute, and the email goes into the app's first fill-in blank. On a Gmail inbox, Also save the reply to my Gmail Drafts saves the result as a draft reply.
  • Mail from before you switch that automation on is never run. Mail that arrives while PromptDeck is closed runs when it next opens.
  • To send from Outlook, press Email on any result, or Reply by email on a Run inbox item that an email started. A window shows the sender, the recipient, the subject and the text, all yours to edit, and asks “Send this email now?” before anything leaves. The sent message is in that account's own Sent folder.
  • An automation, or the agent, can read new mail and work on it. It cannot send.
  • Limits: plain text only, no attachments, one recipient per message, up to six email accounts. A very long email is cut to fit before it reaches an app.
  • Disconnect forgets the account in PromptDeck. To withdraw access completely, remove PromptDeck from the connected apps in your Microsoft account, or delete the app password at Google.

The agent: one job across your apps

Give the agent a job and it works across your apps for you. Open Automations, press New automation and choose The agent. Describe the job in your own words, or start from an example such as Orders by email, then tick the apps it may use and choose what wakes it: a time, every so often, a new file, or an arriving email. You can also ask it something directly on the Agent screen, the lightning icon in the sidebar.

  • It runs on your Preferred model in Settings: your Claude plan through Claude Code, your ChatGPT plan through Codex, or an API connection. If that model is not ready, for example not signed in or no key, the Agent screen says what is missing.
  • It can read the data in the apps you tick, add and change records, and run your task apps. It cannot delete records, send anything, reach your other files or use the internet.
  • Every change it makes is listed under What it did on the Agent screen, with Undo. Tick Ask me before changing any data and each change waits in Needs you instead.
  • Replies it proposes wait in Needs you, and nothing is sent. Approve one and it is saved as a draft in a Gmail inbox connected for drafts.
  • One run happens at a time, and a job runs at most as many times a day as you set: 20 unless you change it, up to 100.
  • A run woken by an email or a new file works only through your apps' data. Runs you start, or that a schedule starts, also get a folder of their own to work in when the agent runs on Claude Code.

Share an app with a colleague

Send someone a prompt app as a single .promptdeck file (the Share action on the app card). They double-click it to open it in their own PromptDeck — it's a file you hand over, not a cloud library or a shared workspace.

  • Import goes behind an approval screen first: it shows the full prompt, which hosts the app will contact, which model will run and that it spends the recipient's own key or subscription, and which secrets they'll need to enter. Nothing is saved until they accept.
  • The recipe travels — name, prompts, chain steps, input fields, data-source definitions, model choice. Your API keys, secret values, and saved rows do not; only the names of the secrets travel so the recipient knows what to supply.
  • For one person building a tool the whole team runs on their own keys, this is the hand-off — no accounts, no server in the middle.

The gallery: apps other owners shared

Open Gallery in the sidebar (or visit gattaca.software/gallery) to browse apps other PromptDeck owners built. Every one was reviewed before it was listed, and they're free. Get it downloads the app's .promptdeck file and opens the same approval screen as a file a colleague sends — nothing is added until you press Import app.

  • The list is fetched only when you open the Gallery; nothing about you is sent. Sort it by Newest or Most liked.
  • To share one of yours, choose Share to the gallery… from the app's More actions menu. With your Gattaca account connected (below), you fill in a title and a sentence about it and it goes straight to review. Without one, PromptDeck saves the file and opens the gallery's form in your browser instead. Either way it's listed once it has been reviewed.
  • Liked an app? Press ♥ on its card, in PromptDeck or on the website. Likes come from PromptDeck owners, one each, so the ranking can't be padded.

Connect PromptDeck to your Gattaca account

In Settings, under Gattaca account, press Connect Gattaca account. PromptDeck shows a short code and opens gattaca.software in your browser; sign in with the email you bought PromptDeck with, check the code matches, and approve. That's all — no password is typed into PromptDeck.

  • PromptDeck keeps its own sign-in token encrypted on your computer. Disconnect it in Settings, or from your account page, at any time.
  • Connecting lets you share to the gallery directly, like apps, and send mini apps to your phone. Everything else in PromptDeck works exactly the same without it.

Send a mini app to your phone

Open a kept mini app and press Send to phone. PromptDeck shows a QR code; scan it with your phone's camera and add the page to your home screen. The app works offline on the phone, and what you change on either side syncs through your account — each entry keeps its most recent change.

  • End-to-end encrypted: the key is made on your computer and travels only inside the QR code, so gattaca.software stores nothing it can read. Anyone with the code or link can open that app, so treat it like a key.
  • On the phone, an app runs with no network access at all, just as it does in PromptDeck. Asking your AI (pd.ask) works on your computer only.
  • PromptDeck includes 3 phone apps; Gattaca Plus raises that to 50. Remove one from the Send to phone window or your account page to free a slot — its link stops working straight away.

Models and cost

  • Claude subscription runs through your local Claude Code installation and uses your existing Claude Pro or Max plan — no API key or separate API usage required.
  • ChatGPT plan runs through OpenAI's Codex (the desktop app or the CLI) and counts against your ChatGPT plan's Codex usage limits, also with no API key. If Codex is signed in with an OpenAI API key instead, Settings says so and those runs are billed per token.
  • Each app remembers its own model, plus a deep-thinking toggle for harder analysis.
  • With OpenRouter you can check your remaining balance right in Settings.
  • When a provider rejects a run (say, an empty credit balance or Claude Code signed out), PromptDeck explains what happened in plain English and what to do about it.

One gateway for every model (optional, for teams)

If your team already runs a LiteLLM gateway, PromptDeck can talk to it directly: Models & Billing → LiteLLM gateway, paste the address it listens on (a locally run one is usually http://127.0.0.1:4000), and PromptDeck checks it's really there and lists the models it serves for you to pick from. Your keys, your spend limits and your provider choices stay on the gateway where you already manage them — PromptDeck just uses the door.

  • Everything works the same once it's connected — streaming answers, follow-up questions and token usage all behave exactly as they do on any other model.
  • Don't have one yet? PromptDeck ships an example config you can save from that screen, so there's something to start from rather than a blank file. LiteLLM's own docs cover running it.
  • Installing LiteLLM yourself? Pin a known-good version, such as pip install "litellm[proxy]==1.106.2". Version 1.107.0, published on 21 October 2026, was a compromised release; if you installed it, follow LiteLLM's security notice before using that machine's keys again.
  • This is an extra route, not a replacement: the Claude subscription, ChatGPT plan, OpenRouter and Anthropic options are all still there and unchanged. One thing a gateway can't carry is the Claude and ChatGPT plan paths — those run through Claude Code and Codex on your own machine with no API key involved, so they stay as they are.
LiteLLM proxy docs →

Keep it tidy

  • Pin the apps you use daily so they sort to the top.
  • Drag to reorder; duplicate an app to experiment without breaking the original.

When something isn't working

The Help page lists common PromptDeck problems with the fix for each. Search it for the words on your screen. If you are still stuck, the contact details are at the bottom of that page.

PromptDeck help →