Cette page n’est pas encore traduite.

Questions and answers

This page is for anyone with a question about instruction.md. Each answer is short and links the page that explains it in full. Questions for developers, such as tokens for automated jobs or connection errors, are in the developer questions.

Jump to: Getting started · Writing · Publishing and versions · Sharing and privacy · AI apps and agents · Teams · Plans and billing · Account and signing in

Getting started

Do I need an account to write an instruction?

No. Open the editor and write. Your work is saved in this browser as you type. You need an account to publish, to use the assistant, and to connect AI apps and agents. See Write without an account.

Where is my work kept if I'm not signed in, and what happens if I clear my browser?

It is kept in this browser only, not on instruction.md. If you clear this browser's data for instruction.md, your instructions and their history are deleted. Use Export all (.zip) in the Storage dialog to keep a copy. See Where your work is kept.

How do I bring my guest drafts into my workspace?

Sign in in the same browser. The editor moves the open instruction and offers to move the rest, and you can move them later from the Instructions page. The copies in this browser stay. See Bring your work into your workspace.

Is there a Save button? How do I know my work is saved?

There is no Save button. The editor saves your draft as you type, and History keeps checkpoints of it as you go. Saving never publishes: agents get your text only when you choose Publish. See Find your way around the editor.

How do I install the editor as an app, and does it work offline?

Choose Install the app in Your account, or in Settings ▸ General. It opens instruction.md in its own window, and works offline. Instructions kept in your browser as a guest don't carry over to the installed app: export them with Storage… and open the files there. See Find your way around the editor.

Are these pages available in my language?

The site's menus, the editor and the sign-in pages are in English, Ukrainian, French, Spanish and Arabic. Most help pages are in English for now. In another language, a page that isn't translated yet shows the English text, with a line that says so.

Writing

How do I turn an existing system prompt or CLAUDE.md into an instruction?

Choose Paste your prompt in the gallery, paste it into Prompt to convert and press Convert. The lines that read like rules become rules, and the rest stays as text. You can also open or drop a file. See Start from a template, a prompt or a file and Move from AGENTS.md, CLAUDE.md and pasted prompts.

What do @, &, # and $ do while I type?

They open a list where you are typing: @ for people and agents, & for tools, skills and APIs, # for this instruction's named rules and blocks, and $ for parameters. Picking a row writes a mention that points at exactly that one. See Mention people, tools and other instructions.

Does naming a tool in an instruction give the agent access to it?

No. A mention tells the agent which tool you mean. What the agent can actually use is set where it runs, and by your organization's integrations. See What an instruction can say and Add the tools your agents may use.

Which parts of my instruction does the agent not receive?

The Details at the top, the Notes at the end, and comments. They are for the people who work on the instruction. Suggestions nobody has accepted aren't in any version either. See How instruction.md works.

Does a workflow in my instruction run by itself when I publish it?

No. Publishing, opening or drawing a workflow never starts it. A workflow runs only in a program built to run workflows, after someone sets it up there. See Who runs a workflow.

What does the assistant send to OpenAI, is it kept, and is it used for training?

Your messages, the instruction you have open, and what it looks up for you go to OpenAI, which processes them in the United States. OpenAI doesn't train on them, and may keep them for up to 30 days to watch for abuse. instruction.md keeps no conversation and no audio, only how much you used. See What is sent, and what is kept.

How much assistant use does my plan include, and why is it 'resting'?

Every plan includes some use, counted in credits. On Community they are yours, given once; on a paid plan they are the organization's and renew each month. The assistant is resting for today means instruction.md's daily limit for all its users together was reached: try again tomorrow. See What your plan includes.

Plans Community 1,000 · Pro 1,500 · Team 2,500 · Enterprise unlimited

Who can turn the assistant off?

The organization's owners and admins, in Settings ▸ Security ▸ Assistant. The switch applies to everyone working on the organization's instructions. See The assistant on or off.

Can I use my own Claude API key in the editor?

Not at the moment. Use the assistant, or connect Claude to instruction.md and write with it in the chat. See Use your own AI to write.

Publishing and versions

What is the difference between a draft, a checkpoint and a version?

The draft is the text you are editing now. A checkpoint is an earlier copy of the draft that History keeps; only the people who work on it see it. A version is what you published, v1, v2 and so on, and it never changes. Agents only ever get versions. See How versions work.

Why is Publish greyed out, or why does it say 'Sign in to publish'?

Hover over Publish to see why: often the draft is the live version already, nothing is written yet, or your role suggests changes instead of publishing. Sign in to publish means you are writing without an account. If the editor lists problems, fix them first. See If it doesn't work and Check your instruction before you publish.

What does 'live' mean, and how do I make an older version live again?

The live version is the one agents get when they follow the instruction without naming a version. History marks it Live. To go back, open History, click the older version, and choose More options ▸ Promote to live…. See Make an earlier version live.

How do I create a 'stable' version for agents, and what happens if it doesn't exist?

Open Publish gates… and click Add stable at v…. It points at the live version. Until you do, an agent can't follow stable: it is told stable wasn't found, and doesn't get the live version instead. See Create stable.

Can I publish without agents picking it up yet?

Yes. Untick Make it live — agents switch to it before you publish. The version is kept and numbered, and agents stay on the one they have until you promote it. See Make it live, or publish quietly.

Can I schedule a publish, and cancel it?

Yes. In Changes, choose Later… beside Publish and pick a time. It publishes the draft as it is then, as you. To stop it, choose Cancel under Scheduled to publish. See Publish it later.

Can I change a version after publishing it?

No. A version never changes, so every agent that has it reads exactly the same text. Edit the draft and publish a new version, or restore old text into the draft from History. See Roll back or withdraw a version.

If I change an instruction's address or archive it, do agents break?

No. Agents and links that use the old address keep reaching it, and the old name stays reserved for your organization. Only if your organization later gives that name to another instruction does the old address lead there instead. An archived instruction is read-only, and agents keep following its published versions. See Change its address and Archive an instruction.

Can I recover something I deleted, and for how long?

Yes, for 30 days. A deleted instruction goes to Trash, and you can restore it from there as it was. Meanwhile, agents keep the last version they have, but get nothing new. See Delete and restore.

Sharing and privacy

Sharing gives named people a role, and they need an account. A read link lets anyone who has it read one version or one name, for as long as you choose, without an account. Public lets everyone read every version, and lists it in Explore. See Read link, sharing or public?

If I make an instruction public, are my drafts and comments public too?

No. Making it public shows its published versions. The draft, its suggestions and its comments stay with the people who work on it. Nothing is shown until the first version is published. See Who can read it.

How do I share a draft with someone who has no account?

A read link shows a published version, never the draft, so publish first. If you write without an account, choose Share ▸ Share a link…: the link carries the text itself, and the other person gets a copy of their own. See Share a draft by link or email.

How do I ask for edit access to someone else's instruction?

Open it and press Request access in the header. Choose what you need, and press Send request. An Admin of the instruction approves or declines it, and you are told in your notifications. See Ask for access to someone else's instruction.

What is the difference between a suggestion, a comment and offered changes?

A suggestion changes a few words in the instruction's own draft, and a Maintainer accepts or rejects it. A comment is a note that never reaches agents. Offered changes are a whole text from your own copy, which a Maintainer merges as a new version. See the table.

How do I use a template or get my instruction listed in Explore?

Press Use on a template in Explore. To be listed, set who can read your instruction to Everyone and publish a version. See How an instruction gets listed.

What is a sealed workspace, can instruction.md read it, and what if I lose my key?

A sealed workspace's instructions are encrypted on its people's devices, and only the people given its key can read them. instruction.md keeps only locked copies of your key, so it can't read them. If you lose every other way to unlock your key, your recovery key is the only way back: instruction.md can't open them for you. Sealed workspaces are in beta, not yet independently reviewed. See Sealed workspaces.

Plans On Team and Enterprise

Is my data stored in the EU or the US, and who processes it?

Your instructions, your account and your sign-in are kept on servers instruction.md runs itself. The assistant is the exception: what you send it goes to OpenAI, which processes it in the United States. If your company signs you in, its sign-in provider handles that part, and the AI apps you connect read what you allow. See Security, privacy and compliance overview and Privacy.

AI apps and agents

How do I connect Claude or ChatGPT, and what can it do in my account?

Add a custom connector with the address https://instruction.md/mcp and sign in. You then choose what it may do: read only, write drafts, publish, or everything. It never does more than your own role allows. See Choose what the app may do.

Why does the AI app ask me before publishing?

Publishing changes what the agents that follow your instruction receive. instruction.md makes the app stop and show you what will happen, and goes ahead only if you agree. See Why it asks you first.

Why doesn't my second agent get updates on the free plan? Does it still work?

It still works. On Community, one agent or AI app at a time gets live updates, the moment you publish. The others read the latest version whenever they check, and reading is never limited. See Reading and live updates.

Plans Community 1 · Pro unlimited · Team unlimited · Enterprise unlimited

How do I see which agents follow an instruction and which version each one has?

Open the instruction and choose the faces in the header. The Agents card lists each agent with its state and the version it has. Admins of the instruction see every agent; everyone else, Maintainers included, sees only their own. See Read the card.

How do I pause updates to one agent, or disconnect it?

On the agent's row in the Agents card, choose the pause button (Pause updates to …) or the disconnect button (Disconnect …). Pausing keeps it on its version until you resume, and only Admins of the instruction can pause. Disconnecting takes it off the list, but doesn't change what it may read. You can disconnect your own agents; Admins can disconnect anyone's. See Pause, resume or disconnect an agent.

How do I make my team's Claude Code or Codex follow an instruction?

Open the instruction and choose Share ▸ Follow in your coding agent…. Pick the tool and the version, and have a developer run what it gives once in the project's folder; everyone on the project then follows it. To cover every developer in the company, your IT team installs the settings instead. See Make your team's coding agents follow an instruction and Roll an instruction out to every developer.

How do I run an agent for every instruction in a project, and which plan do I need?

Make a rule: open the project's ⋯ menu, choose Run every instruction here on…, and have someone run what it gives on the machine. Only the organization's owners and admins can make one. See Run your instructions as agents.

Plans On Team and Enterprise

How do I answer an agent's permission request, and what if nobody answers?

Open the card from your notification, read it, and choose Allow, Allow for this run or Deny. If nobody answers in time, 30 minutes unless the rule says otherwise, the request is denied. See When nobody answers.

Can I control my agents from my phone?

Yes. Open the Agents app on your phone, or follow the notification when an agent asks you something. You can answer, write, interrupt and restart there, as on a computer. See The Agents app.

What leaves the machine when an agent asks me something? Are secrets sent?

The card carries what the agent would do, such as the command it would run. Anything that looks like a password, a token or a key is replaced with ••• before it leaves the machine. See What leaves the machine.

Teams

What is the difference between an organization and a workspace?

The organization is the team: it holds the plan, the bill, the people, the rules, the apps and the keys. A workspace is a place inside it that holds instructions, projects and folders. One organization can have several workspaces, depending on its plan. See Organizations and workspaces.

Why is New workspace greyed out?

Either you are in your personal organization, which keeps one workspace, or you aren't an owner or an admin, or the organization has as many workspaces as its plan allows. See The organization and workspace menu.

Plans Community 1 · Pro 1 · Team unlimited · Enterprise unlimited

What can a Reader, a Contributor, a Maintainer and an Admin do?

A Reader reads. A Contributor suggests changes and comments. A Maintainer edits, accepts changes and publishes versions. An Admin also shares the instruction, decides who has access, and renames, archives or deletes it. See The roles.

In Settings ▸ People, write their email, choose their role and choose Invite. Send them the link it shows: instruction.md doesn't send it for you. The link works once, for 14 days. See Invite someone.

How do I stop agents from publishing on their own?

Leave Agents may publish off in Settings ▸ Security, which is where every organization starts. Agents then suggest changes, and a person publishes them. See Agents may publish, or only suggest.

How do I allow only our approved MCP servers and block a tool?

Add your servers, then turn on Only approved integrations in Integrations ▸ Overview. To block a tool, press Tools on its server's row and choose Blocked. The two come with different plans: blocking a tool with the first line below, Only approved integrations with the second. See Allow or block tools.

Plans On Pro, Team, and Enterprise

Plans On Team and Enterprise

Can I add our internal API from an OpenAPI document? Does instruction.md call it?

Yes. Add the document's address, or upload the file. instruction.md reads only the document and never calls the API. A token for the document is used once and never kept. See Add the tools your agents may use.

How do I connect Okta or Entra ID: a people directory or SCIM?

Use a directory to let writers name your people. Use SCIM to have Okta or Entra ID add and remove your members by themselves. You can use both. A directory comes with the plans in the first line below, SCIM with the second. See Bring in your company's people.

Plans On Pro, Team, and Enterprise

Plans On Team and Enterprise

Who changed this rule and when? Can I export the activity log for an auditor?

If you are an Admin of the instruction, open its History, then Activity, to see who did what and when. For the whole organization, owners and admins open the Activity page, and export it with CSV or NDJSON at its end. The log never holds the text of an instruction. See See who did what.

Plans and billing

Is instruction.md free? What does each plan include?

The Community plan is free. Pro, Team and Enterprise add private instructions, people, agents and controls for teams. The plans page compares them, and Plans, limits and billing explains each limit.

How do I upgrade, cancel or find invoices? What if a payment fails?

An owner, an admin or the billing admin opens Settings ▸ Billing. It offers the plans you can buy, and once you pay, Manage billing opens the payment pages, with invoices and cancelling. If a payment fails, the plan keeps working for 7 days while it is tried again; meanwhile you can't add people or private instructions. If paid plans aren't open yet, Billing says so, and nothing is billed. See Plans, limits and billing.

What happens when I reach my plan's limit of private instructions or versions?

A new private instruction is refused, with what you can do: make one public, delete one, or upgrade. Versions are counted each month: once this month's are used, publishing is refused until the next month. Your instructions and the agents that follow them keep working. See Plans, limits and billing.

Plans Community 3 · Pro 100 · Team 1,000 · Enterprise unlimited

Plans Community 200 · Pro 1,000 · Team 10,000 · Enterprise unlimited

Do guests count as paid seats?

No. Guests take no seat and are never billed. Everyone else does, including billing admins. Agents don't take seats either. See Invite people and choose their roles.

Plans Community 3 · Pro 1 · Team 10 · Enterprise unlimited

Which plan has company sign-in?

Setting up company sign-in isn't available yet. When it is, it comes with the plans shown below. You can prove your web domains now, so they are ready. See Company sign-in (single sign-on).

Plans On Enterprise

Account and signing in

I lost my phone with my passkey. How do I get back in?

Try these in order: sign in on another device that has your passkey; use one of your recovery codes; sign in through your organization, if it has its own sign-in; or ask us and choose I can't sign in. See Lost your passkey?

Can I sign in with a password, or with Google, Apple or Microsoft?

instruction.md has no passwords. You sign in with a passkey, or through your company's sign-in if it uses one. Signing in with Apple, Google or Microsoft isn't available yet. See Signing in.

Which emails from instruction.md are real?

We never send a sign-in link or a sign-in code by email, and we never ask for your recovery codes. Our emails tell you what happened, such as "A sign-in method was added to your account" or "Someone tried to sign in to your account". If an email asks you to sign in through a link or type a code, it isn't from us. See Signing in.

How do I sign out a device I no longer have?

Open Your account ▸ Security. Under Where you're signed in, choose Sign out beside that device, or Sign out everywhere else. If you lost the device, remove its passkey on the same page. See Your devices and linked sign-ins.

How do I change my email address?

You can't change it in the editor or on the sign-in pages. To change it, send us a request and choose My account. See Profile, notifications and appearance.

Which apps can act as me, and how do I limit or disconnect them?

Open Your account ▸ Connected apps. Under AI apps acting as you, choose Change what they may do, pick what each may do, or tick Disconnect this app, then Save. See Connected apps.

How do I download all my data or delete my account? Why is deletion refused?

Open Your account ▸ Privacy. Download your data gives one .zip with your instructions and your account's details. Delete account is on the same page; it is refused while you alone own an organization, so make someone else an owner or delete the organization first. See Your data: privacy switches, download, delete.

Can I use the editor in Ukrainian, French, Spanish or Arabic, or in dark mode?

Yes. Open Your account ▸ Appearance and choose a Language, and a Theme: System, Light or Dark. Your instructions stay in the language you wrote them in. See Profile, notifications and appearance.

Can I use the editor with a keyboard only or a screen reader?

Yes. Every command is in the command palette, and Keyboard shortcuts and the command palette lists every key. Accessibility explains how the editor works with screen readers and right-to-left languages.

Still have a question?

Look in Something isn't working for a message you see, or ask us.

Last checked against the product:

Was this page helpful? Report a problem