← 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.

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.47.exe, about 85 MB) and double-click to run it; the first launch unpacks the app, so set aside roughly 300 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.

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.
  • Turn on “Ask me before running” 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, crew work, 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.

Crews: several apps, one goal

A crew is a team of your own saved apps. Connect the ones you want, describe the goal — “launch the spring menu this Friday” — and a coordinator splits it into assignments for them. Each app works on its own model and knowledge, and you can see every handoff.

  • Specialists can't hand work on to each other; the coordinator assigns everything.
  • Any step that reaches outside the crew, like emailing customers, waits for your approval before it runs.
  • Planning is a real model call on the coordinator model you pick, and each assignment is a normal run of that app.

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. 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.
  • 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.