Documentation
Everything you need to go from first compile to mastering every Kosmo feature.
What is Kosmo?
You describe what you need. Kosmo turns it into an expert prompt for your AI tool.
Kosmo is an AI prompt compiler. Instead of spending 20 minutes crafting a prompt, you type what you want in plain English ("build me a dashboard with auth and Stripe billing") and Kosmo compiles it into a structured, tool-aware prompt specification that's grounded in the latest official documentation for whichever AI tool you're targeting.
Think of it as a translator between your brain and your AI. You bring the intent; Kosmo handles the prompt engineering, fact-checking, guardrail injection, and formatting. The output is ready to paste into ChatGPT, Claude Code, Cursor, or any other supported tool.
Kosmo talks with you to understand the task, but its job is the prompt, not the answer. It produces specifications that make your existing AI tools far more effective.
Getting Started
Getting started with Kosmo takes a couple of minutes. Here's the walkthrough:
- Sign up: Use your email or your Google account. No credit card required. You get 3 free compiles: 2 straight away and 1 more two days later.
- Write your first request: Type what you need in the input console. Write it the way you would explain it to a colleague. The more of your situation you include, the better the prompt (see ). Example: "Build a Next.js API route that handles Stripe webhooks with proper signature verification."
- Name your tool: Say which AI tool you'll paste the output into (Claude Code, ChatGPT, Cursor and so on). If you don't, Kosmo asks, or picks a sensible one and tells you.
- Answer a few questions: If something important is open, Kosmo asks up to three quick questions. Tap an option if it fits exactly; otherwise type your own answer. If it already has enough, it skips them.
- Compile: A compile takes about a minute. Kosmo reads live docs, applies the craft of the field, and returns the prompt with a short note on which model or mode to pick.
- Copy & paste: Take the compiled output and paste it directly into your AI tool. Watch the difference in quality.
Getting the Best Results
Before launch we put Kosmo through 39 realistic requests, each one a full conversation with a test user doing a real job: reviewing a contract, migrating a login system, planning a Midjourney shoot, training a warehouse team. Then we read every prompt side by side.
One thing decided quality more than anything else. The prompts built on the person's own situation were better than the ones built on guesses. In 17 of the 39 comparisons, the weaker prompt lost for exactly that reason: the details that mattered never came up.
Kosmo already brings the expertise of the field. What it cannot know is your situation. So the rule is simple: say more, get more.
Tell Kosmo what only you know
You do not need to know anything about prompts. Write the way you would brief a sharp colleague on their first day. These are the details that changed the result most in our tests:
Who it is for
The same task looks completely different for different people.
In our tests: "Volunteers who are retired and not comfortable with software" turned a process document into a low-tech one they could actually follow. "25 warehouse staff, mixed confidence" turned a slide deck into a hands-on workshop.
Your real setup
Tools, systems, team size and rules make a plan specific instead of generic.
In our tests: "Stripe and NetSuite, three people, US GAAP, yearly audit" turned a sound but generic month-end plan into a day-by-day plan for that team.
Where the result will end up
It decides the format, the size and how much to build.
In our tests: "For a usability test on a Friday screen-share" got a clickable four-screen prototype instead of a full app. "On bags, the shop window and Instagram, in one colour" got a logo that works small.
What went wrong before
Past failures are the best guide to what to prevent.
In our tests: "People who interview well but cannot do the job" got interview questions built to test the real work. A grant rejected for formatting got a formatting check.
The exact words
Kosmo carries your words; it never makes up your title, name or text.
In our tests: "The thumbnail says Shutter Fixed, nothing else" got exactly that. Without the words, the prompt leaves a clear placeholder for you.
Size and deadline
Scope changes the plan.
In our tests: "About twelve images that hang together" got twelve scenes on one shared look. "Due Thursday" got a plan that puts the urgent part first.
What is decided and what is open
Kosmo keeps your decisions fixed and only fills real gaps.
In our tests: A stated stack, budget or rule stays in the prompt as a fixed rule instead of a suggestion.
Answer the questions in your own words
When something important is open, Kosmo asks up to three questions and offers quick options under each one. The options are there to save time, not to replace your answer.
- Tap an option only when it is exactly right.
- Otherwise type, even one sentence. In our tests, the most common reason for a generic prompt was a conversation answered entirely with tapped options. Each tap was reasonable, but the person's real situation never came out.
- Add what was not asked. If something matters and Kosmo did not ask about it, say it anyway.
Paste what you already have
Drafts, notes, a list of dishes from a message, error messages, existing copy, the clause you are worried about. Kosmo carries your facts, prices and numbers into the prompt as they are.
Say what should happen to it:
- "Tidy this up but keep every price and the phone number" lets the AI improve the wording.
- "Use these words exactly" keeps them untouched.
Messy is fine. One long, unpunctuated message with all the facts beats a tidy one without them.
Name your tool, and what you will give it
Say which AI tool you will paste into (see Supported AI Tools). If you are not sure, say what you have access to and Kosmo picks one and tells you why.
If you will add files in that tool, such as a photo of yourself, a colour reference or a spreadsheet, tell Kosmo. It cannot see them, but it writes the prompt to use them. In our tests, "I'll add the rider photo and a colour-grade image" got a prompt built around both.
After the compile
- Read the short note at the end. It says which model or mode to pick in your tool.
- Paste the whole prompt. The checks at the end are part of it.
- Want a change? Say it in the same chat. "Make it shorter", "it's for beginners", "add a budget section". Kosmo updates the prompt and tells you what changed and what it kept. An update costs one compile; a request that changes nothing costs nothing.
- Have a question about the prompt? Just ask. Chat is free within the daily allowance shown at the top of the app.
What Kosmo will not do
- It will not write your content for you. It carries your words and steers the tool. Where a title, name or figure is missing, it leaves a clear placeholder instead of inventing one.
- It will not invent facts. When a number has to be real, the prompt tells the AI to find a published source and cite it, or to leave a gap.
- The prompt is not the answer. Your AI tool does the work. Check important details before you rely on them.
Before and after
Thin
"Make a training for my team on the new system."
Rich
"I train 25 warehouse staff on our new inventory system, and their confidence with computers is mixed. Three things matter: receiving, picking and stock counts. It's one 90-minute session on the tablets they use on the floor. The last rollout failed because people got slides and never practised. It's for Claude."
Both get an expert prompt. Only the second gets one built for those 25 people.
Quick check before you send
- Which tool will you paste this into?
- Who is it for?
- What is your setup: tools, numbers, rules?
- Where will the result end up?
- What went wrong last time?
- Are there exact words it must use?
- How big, and by when?
You do not need all seven. Every one you add makes the prompt more yours.
The Compile Pipeline
A compile does more than pass your words straight to an AI model. Knowing roughly what happens in between helps you write better inputs and read the output with more confidence:
- Kosmo works out what you actually want to build or accomplish, including things you implied but didn't say outright.
- It checks current, official documentation for whatever tools, libraries, or frameworks are relevant, so the result isn't based on stale training data.
- It applies the professional practices an expert would use by default, security, error handling, sensible structure, even if you didn't ask for them directly.
- For anything complex, it structures the output so your target AI reasons through the problem instead of guessing at an answer. See for more on this.
- It formats the result the way your specific target tool actually expects it and hands you a copy-ready output. Each compile costs exactly 1 credit, whatever the complexity. Updating a prompt in the same chat is also one compile; a request that changes nothing is free.
Vent Mode
Not every question belongs in your main thread. Maybe you want to ask something basic without feeling judged for it ("why does this use Next.js instead of plain HTML?"). Maybe you just want to think out loud, vent about a bug that's been driving you crazy, or go on a tangent that has nothing to do with what you're actually building. None of that should cost you the focus of your real work. That's what Vent Mode is for.
Vent Mode is a mirror of your main chat. It sees the same context, so you never have to re-explain what you're working on. But it's a separate space, so nothing you say there touches or derails your main thread. It's a real conversation, not a one-way inbox: you can talk back and forth with Kosmo in Vent Mode the same way you would in your main chat.
What Vent Mode does not do is compile a prompt. That's not what it's for. It exists so you have somewhere to clear your head, ask the "obvious" question, or process a frustration, without any of it leaking into or cluttering the thread where you're actually building something.
Nothing you say in Vent Mode gets saved anywhere automatically. If something you said turns out to be worth keeping, a real idea worth coming back to, you choose to save it to your Idea Library yourself. Venting and saving are two separate, deliberate actions.
Vent Mode never touches your compile credits. It's free, every time, because it was never meant to produce a compile in the first place.
Idea Library
When you're building something, ideas do not arrive one at a time on schedule. They show up constantly, usually while you're in the middle of something else entirely. Chasing every one of them the moment it occurs is a good way to never finish anything. The Idea Libraryis where you park an idea that's genuinely good, but whose timing isn't right yet, so you can stay focused on what you're actually doing and come back to it later.
Nothing lands in your Idea Library automatically, not from your main chat and not from Vent Mode. You have to manually choose to save an idea, from wherever it came up. That's deliberate: the library is for ideas you decided are worth keeping, not a transcript of everything you ever typed.
Every idea has a status:
- Active, a fresh idea you just saved.
- Parked, set aside until the timing is right.
- Resurfaced, Kosmo brings a parked idea back to your attention after 7 days, so the right moment doesn't just pass you by.
- Implemented or Archived, mark an idea done once you've acted on it, or archive it if it's no longer relevant.
Supported AI Tools
Kosmo doesn't write one generic prompt for every tool. These tools have their own verified profile, checked against each tool's official documentation:
| Tools | What Kosmo writes for them |
|---|---|
| Claude, ChatGPT, Gemini | Prompts structured the way each assistant reads best, with a note on which model and mode to pick. |
| Claude Code, Claude Code Desktop, ChatGPT Codex, Cursor | Instructions written for the coding agent's own features, such as project rules files, plan mode and subagents, with checks the agent can run itself. |
| Antigravity (IDE, CLI, SDK and 2.0) | Instructions written for each Antigravity surface and the way it plans and runs work. |
| Lovable, v0, Emergent | A build brief written for how each app builder works, so the first result is closer to what you meant. |
| Perplexity | Research prompts built for cited, search-grounded answers. |
| Midjourney | Image prompts written for the tool directly, with its own parameters. |
If you don't name a tool, Kosmo asks, or picks a sensible one and tells you which. It can also write for a tool that has no profile yet, using that tool's current documentation.
Knowledge Vault Coverage
The tools listed above are the ones Kosmo formats output for directly. Behind that, Kosmo's knowledge vault holds current, official documentation across a much wider range of frameworks, providers, and standards, so a compile can ground itself in the right facts no matter what you're building with. This list grows as the vault does.
AI Prompt Tools & Assistants
Model Providers
Google Developer Ecosystem
Agent Protocols & Frameworks
Frontend Frameworks
Backend Frameworks
Databases & Data Infrastructure
Deployment & Infrastructure
Testing
Observability
Billing & SaaS Operations
Data Extraction
RAG Architecture
Prompt Engineering Research
Security & Compliance
Design Reference & Accessibility
Web & Data Standards
Long-Term MemoryComing Soon
Long-Term Memory is not available yet.
Today Kosmo keeps your chats, prompts and saved ideas in your account, but it does not carry your preferences from one conversation to the next. Remembering your stack, style and past decisions across conversations is planned for later.
Loop Engineering
Loop Engineering is how Kosmo gets AI tools to check their work before they hand it over. Instead of asking for a single-pass answer, the compiled prompt tells the AI how to plan, do the work, and then check the result.
What does that look like?
The prompt spells out the sequence: understand the task, plan the approach, do the work, then check it against what you asked for and fix what does not hold up. This prevents the common failure where an AI produces something plausible-looking but wrong on the first attempt. The check is written into the prompt you can read; nothing is hidden.
Where it matters most
- Coding agents: the check is something the tool can run itself, such as tests, a build or a linter, so it keeps going until the check passes instead of stopping when the work looks done.
- Research and analysis: facts are checked against current sources, and guesses are labelled as guesses.
- Writing and planning: the draft is checked against your constraints, such as length, tone and the details you gave, before it is handed back.
Short, simple requests get a short prompt: the check scales with the task.
Agent Soul Files
Some AI agent frameworks (like Hermes and OpenClaw) define an agent's personality and behavior in a dedicated SOUL.md file, separate from its system prompt. Kosmo has current documentation for both frameworks' conventions grounded in its knowledge base, so it can compile an accurate SOUL.md for either one, not a generic template.
Describe the agent's role, personality, and rules in plain language, and Kosmo compiles it into the structure that framework actually expects, grounded in its real, current documentation.
Themes & Customization
Kosmo ships with three carefully designed themes that adapt every surface, border, and text color across the entire interface:
Dark
Pure black background with subtle chrome highlights. Easy on the eyes for late-night sessions.
Grey
Warm charcoal surfaces with softer contrast. A middle ground between dark and light.
Light
Clean white background with crisp borders. Optimized for bright environments and readability.
Switch themes with the theme button in the site header or the app sidebar, or in Settings under Appearance. Your preference is saved locally and persists across sessions.
Credits & Billing
Kosmo uses a simple credit-based system. Each compile costs exactly 1 credit, regardless of complexity.
| Plan | Price | Compiles | Extras |
|---|---|---|---|
| Pay As You Go | Free start | 3 free, then $5 / 12 | No card required, top-ups valid 30 days |
| Pro Creator | $9.99/mo | 40 / month | Full compile history |
| Kosmo Max | $19.99/mo | 90 / month | Everything in Pro |
Top-up vs subscription: Pay As You Go users can buy credit packs ($5 for 12 compiles) that expire after 30days. Subscribers get their full allotment on each billing cycle, and unused credits don't roll over. You can switch plans or cancel anytime from account settings.
In India: Pro Creator is ₹499 a month for 25 compiles, Kosmo Max is ₹1,499 a month for 80, and the top-up pack is ₹199 for 8.
Prices can change for future purchases. Plan holders are told before their next renewal.
Keyboard Shortcuts
Kosmo keeps input handling deliberately simple:
| Shortcut | Action |
|---|---|
| Enter | Submit the current input |
| Shift + Enter | Insert a new line without submitting |