Cette page n’est pas encore traduite.

Something isn't working

This page is for anyone who sees a message they don't understand, or something that doesn't happen as it should. Find what you see in the tables below. Each row says why it happens, what to do, and which page tells you more.

The words in bold are what instruction.md shows you. If you see something that isn't here, the page about that task usually has its own list under If it doesn't work.

In the editor

What you see Why What to do
Publish is greyed out Something stops you publishing right now. Hover over the button: it says why. See the next rows, or Publish a version.
The draft is live v3 already — nothing to publish (with your version) Nothing changed since the live version. Change the text first, or nothing needs doing.
Nothing written yet — nothing to publish The instruction is empty. Write something first. See The editor.
Maintainers publish versions — your suggestions go in once accepted You are a Contributor. A Contributor suggests, and a Maintainer publishes. Ask a Maintainer to accept your suggestions and publish. See People and roles.
2 problems to fix before you publish. (with the real count) The editor found problems a version can't carry. Open Problems and fix them. See Check and fix.
Sign in to publish You are writing without an account. Your work stays in this browser. Sign in, then publish. See Write without an account.
It's kept only in this browser — move it to your workspace to publish it The instruction was written before you signed in, and it is still only in this browser. Open its menu, choose Move to your workspace, then publish. See Bring your work into your workspace.
Nothing here you can open There's nothing at this address, or it isn't shared with you. Check the address. If someone sent it to you, ask them to share it with you. See Share an instruction.
Sign in to open this The instruction is shared with you, or only for your organization. You aren't signed in. Sign in. It opens once you are.
This draft is only in the browser that wrote it A draft written without an account stays in the browser it was written in. Open it in that browser, on that device. See Write without an account.
Work you wrote as a guest is missing after you sign in Guest work stays in the browser, and isn't moved by itself. Sign in in the same browser, then move it to your workspace. See Write without an account.
That instruction is in Recently deleted — restore it first The instruction was deleted. Restore it from Trash. See The Instructions page.
Offline, or a message that ends check your connection and try again The editor can't reach instruction.md. Check your internet connection, then try again.

Agents

An agent here is anything that follows an instruction: a coding agent, an AI app, or an agent your team runs.

What you see Why What to do
An agent doesn't have the new version Each kind of agent takes a new version at its own moment. A coding agent such as Claude Code takes it at your next prompt. Wait for its next step. See When a new version reaches a running session.
An agent still has the old version, long after you published The agent follows stable, or one exact version, not the live one. Or you published without making the version live. Move stable, or make the version live. See Keep agents on a stable version and Make it live, or publish quietly.
An agent shows Behind in Settings ▸ Deployments, or told, not switched on the Agents card It was told about the new version and hasn't taken it yet. Wait for its next step. See See your agents.
The agent or AI app is told that one agent or AI app gets live updates at a time On the Community plan, one agent or AI app at a time gets live updates in a workspace. Another one has them now. Nothing breaks: the agent still reads the latest version whenever it checks. Try again once the other has stopped. Paid plans have no such limit, but they can't be bought yet. See Live updates on the free plan.
Needs sign-in, or a line such as GitHub needs a sign-in A tool the agent uses isn't signed in on the machine it runs on. Whoever runs that machine does what the line under the agent says. See Run your instructions as agents.
Waiting for approval, or v4 waiting for approval In an organization, a new agent waits for an owner's or an admin's approval. So does a new version, when the rule says so. An owner or an admin approves it in Settings ▸ Deployments. See Approve new agents and versions.
Not running, Failed or Degraded The agent stopped, or its machine reports a problem. Ask whoever runs the machine to check it. See Run your instructions as agents.
Publish it first: an agent runs a released version. The instruction has no published version yet. Publish it, then choose Share ▸ Deploy to… again. See Publish a version.
(not delivered yet) after your message to an agent The agent hasn't read your message yet. Wait a moment. See Answer your agents.

Claude, ChatGPT and other AI apps

What you see Why What to do
No sign-in page opens when you connect the app The address is wrong, or the app's settings block it. Check the address is exactly https://instruction.md/mcp. In ChatGPT, check that Authentication is OAuth. See Connect Claude or ChatGPT.
The app says it can't connect, or shows no actions The app is too old. instruction.md only accepts the newest way AI apps connect. Update the app, then connect again.
The app can't manage your organization's people, workspaces or billing Managing an organization needs Everything you can do when you connect, and the app must ask for it too. Claude and ChatGPT usually don't. Manage your organization in the editor's Settings instead. See Choose what the app may do.
The app does less than you expected You chose what it may do when you connected it. Check it under Your account ▸ Connected apps. See Connected apps.
The app says it can't find the instruction The app sees only what you can see. A private instruction that isn't shared with you is hidden from it too. Check the name, and that you can open it in the editor. See Who can read it.
The app can't find the stable version stable exists only once someone creates it. instruction.md never gives the live version instead. Create stable first. See Create stable.

Sealed workspaces

A sealed workspace keeps its instructions encrypted on its people's devices. It is in beta, not yet independently reviewed. See Sealed workspaces.

What you see Why What to do
You don't have this workspace's key yet. Nobody has given you the workspace's key. Ask someone who has it to give it to you in Settings ▸ Workspaces. Then try again.
This instruction is sealed, with Set up your encryption key, then someone who has this workspace's key gives it to you. You have no encryption key yet. Set up your encryption key. Then someone who has the workspace's key gives it to you.
Unlock your encryption key first. Your key is locked in this tab. Unlock it with your passkey, your security key or your passphrase.
That didn't unlock your key. Check what you entered and try again. The passphrase or the recovery key isn't right. Enter it again, or unlock another way.
This browser no longer keeps its key. Use another way to unlock. The key this browser kept is gone, for example after its data was cleared. Unlock with your passkey, your passphrase or your recovery key.
This browser or this key can't be used to unlock. Try another way, or a passphrase. This browser or this security key can't unlock encryption keys. Use another browser, another key, or your passphrase.

The assistant

What you see Why What to do
The Assistant button is missing The instruction is sealed, or you are reading a preview. See If the button is missing.
The assistant is turned off for this organization. An owner or an admin turned it off. Ask them. See Turn it off for your organization.
The assistant isn't available here. The service you are using has no assistant. Use the editor at instruction.md.
The assistant is resting for today. Try again tomorrow. instruction.md sets a limit for all its users together each day, and it was reached. Try again tomorrow.
This month's assistant allowance is used. On a paid plan, your organization's credits for this month are used up. Wait until it renews. The message says when, if it knows. See What your plan includes.
You've used the assistant included with Community. Upgrade to keep using it. On Community, your credits are given once, and they are used up. A paid plan renews them every month, but paid plans can't be bought yet. See Plans, limits and billing.
The assistant is busy. Try again in a moment. Too many requests came at once. On Community, it also shows when a lot of free use came from your network today. Wait a few seconds, then send it again. If it keeps showing, try again tomorrow.
The microphone is blocked. Allow it for this site in your browser's settings, then press Talk again. Your browser doesn't let instruction.md use the microphone. Allow the microphone for instruction.md in your browser's site settings.
No microphone could be used. Connect one, then press Talk again. No microphone is connected, or it is in use. Connect a microphone, or choose another one in your computer's sound settings.
The conversation couldn't be set up from this network. Try again, or try another network. Some company networks block voice calls. Try another network, or type instead.

Invitations

What you see Why What to do
This invitation can't be used: it was used already, withdrawn, or it expired. Ask whoever sent it for a new one. The link was accepted already, withdrawn, or is too old. Ask an owner or an admin of the organization for a new invitation.
This invitation is for another address; sign in with the address it was sent to. You are signed in with another email address. Choose Use another account, and sign in with the address it was sent to. See Accept an invitation.
That isn't an invitation link. Paste the whole link from the email. Part of the link is missing. Copy the whole link from the email again.
No invitation is waiting here. Paste the link you were sent to join its organization. You opened the page without the link. Paste the link into The invitation link, then choose Accept.

Signing in

instruction.md has no passwords. You sign in with a passkey, or with your organization's own sign-in. If you lost your passkey, follow Lost your passkey? in its order.

What you see Why What to do
This browser can't use passkeys. Try an up-to-date Safari, Chrome, Edge or Firefox. The browser is too old, or doesn't support passkeys. Update the browser, or use another one. See Passkeys.
We couldn't use your passkey. It may have been cancelled or timed out. The passkey prompt was closed, or took too long. Choose Try again, and finish the prompt on your device.
We don't recognise that passkey. The passkey isn't one of your account's, or it was removed. Use another passkey or a recovery code. See Lost your passkey?.
That recovery code isn't right. The code was mistyped, or it was used already. Each code works once. Check the code, or use another one. See Recovery codes.
We couldn't find that email address. No account uses that address. Check the address. If you don't have an account yet, see Sign in.
Your browser blocked a cookie we need. Allow cookies for this site and try again. The browser blocks the cookie that keeps you signed in. Allow cookies for instruction.md, then try again.
This page has expired The sign-in page was open too long. Choose Start again, or Pick up where I left off.
This account is paused for a while. Try again later, or ask your organization's admin. Several sign-ins didn't succeed, so the account is paused. Wait, then try again.
This account is turned off. Ask your organization's admin for help. The account was turned off. Ask your organization's admin, or ask us.
You're signed in on too many devices. Sign out on one and try again. Your account is signed in on more devices than it may be. Sign out on a device you don't use. See Devices.

Still stuck

What you see What to do
You can't sign in at all Ask us, choosing "I can't sign in".
A question about your plan or a charge Ask us, choosing "Billing and plans".
Something about your account you can't change yourself Ask us, choosing "My account".
Anything else Ask us, choosing "Something else". Say what you did, what you expected, and the exact words you saw.

For developers: error codes, the command line and the MCP server have their own list in Troubleshooting.

Last checked against the product:

Was this page helpful? Report a problem