Organize your instructions
This page is for anyone with more than a few instructions. You will learn to find any instruction, group them in projects and folders, star the ones you use most, and tidy up with archive, move and delete.
Before you start
- What you need: the editor. Without an account, everything here works on the instructions kept in your browser. Sharing, archiving, changing an address and moving to another workspace need you to be signed in.
- Who can do what: anyone who can edit an instruction can rename it, duplicate it and move it into a folder. Anyone who can read it can star it. Only an instruction's Admin can archive it, change its address, move it to another workspace or delete it. Roles are explained in Share an instruction.
Find an instruction
Press Instructions in the side bar. The page shows your projects at the top, then your instructions. Under Instructions in the side bar are five more places:
| Place | What it shows |
|---|---|
| All | Every instruction, in a project or not. |
| Drafts | Instructions not published yet. No agent follows them. |
| Shared with me | Instructions others share with you, with what you may do: can read, can suggest, can edit, can publish or can manage. You need to be signed in. |
| Starred | Your favorites. |
| Trash | What you deleted. You can restore it, or delete it forever. |
To change how the page looks, use the buttons at the top of the page:
- Show picks All, Favorites or Live (only instructions with a published version).
- Sort and layout sorts by Last edited or by Name, and shows them as Cards or as a List. The editor remembers your choice in this browser.
- Search instructions finds instructions whose name has the words you type.
Each card has small labels. v3 (or another number) means the version agents get now. archived means it is read-only. open is the one open in the editor. This browser means it is kept only in this browser, and This browser's copy means this browser also keeps a copy of it. Sealed means only people with its key can read it.
To find an instruction by what it is about, not only its name, press Ctrl+P (⌘P on a Mac), or the Search instructions button beside Instructions in the side bar. Type a phrase of a few words, such as "refunds over the limit". When you are signed in, the list adds instructions whose text means something close, marked by meaning.
If you have signed in after writing some instructions without an account, they sit in a folder called This browser. The band at its top offers Move them to your workspace. Write without an account explains what that does.
Group instructions in projects and folders
A project keeps instructions together, for example one per team or per agent. A project can hold folders, and folders can hold more folders.
Make a project
In the side bar, under Projects, press Create project, type its name and press Enter. The project shows in the side bar.
Or, at the top of the Instructions page, press New ▸ New folder, type the project's name and press Create. The project opens. Its band says how many folders and instructions it holds, with Rename and Delete… beside it.
Add a folder inside it
Inside the project, press New ▸ New folder. Or, in the side bar, open the project's More actions menu and choose New folder….
Put instructions in it
Drag an instruction's card onto a folder or a project. You can also drop it on a step of the path at the top of the page, to move it up. To move without dragging, open the instruction's ⋯ menu, choose Move to…, and pick the place.
To start a new instruction in a project, press New ▸ New instruction inside it, or the pencil beside the project in the side bar.
Folders move the same way: drag one onto another folder. Projects stay at the top and are not dragged.
When you are signed in, a project's or a folder's ⋯ menu also has Run every instruction here on…. If your plan or your role doesn't allow it, the item is greyed out and says why. Run your instructions as agents explains it.
Star your favorites
Open an instruction and press the star beside its name, Add to favorites. It is now listed under Starred in the side bar, and Show ▸ Favorites shows only your favorites. Press the star again to remove it.
Rename, duplicate or move an instruction
Every card and row has a ⋯ button. Its menu has:
- Rename…: type a new name in place and press Enter. The toast has Undo. This changes the name people see. Its web address stays the same.
- Duplicate: makes a copy beside it, with Open in the toast. The copy has the same text but no versions, so publishing it makes a new instruction. When you are signed in, the copy's name ends in "copy", and a copy of a public instruction starts private. A sealed instruction can't be duplicated.
- Move to…: a project or a folder. For an instruction's Admin, the list ends with Another workspace….
- Share… and Copy link, when you are signed in. See Share an instruction.
- Delete, explained in Delete and restore.
Archive an instruction
Archive an instruction you no longer change but don't want to lose. It becomes read-only for everyone but its Admins. Agents keep following its published versions.
- Open the instruction's ⋯ menu on the Instructions page.
- Choose Archive.
The toast says "Archived … read-only for all but its admins; agents still follow its versions", with Undo. The card gets the archived label. When someone opens it, the editor says it is archived.
To change it again, choose Unarchive in the same menu. You can also find Archive this instruction and Unarchive this instruction in the command palette (Ctrl+K, or ⌘K on a Mac).
Change its address
Each instruction has a web address made of its organization's name and its own short name, such as acme/support-agent. Agents and links use this address. You can change the short name.
- Open the instruction's ⋯ menu and choose Change its address….
- Type the new name after the organization's name. Use lowercase letters, digits and hyphens.
- Press Change it.
The toast says its new address, and that the old one keeps pointing at it. Agents and links that use the old address keep reaching it. The old name stays reserved for your organization. If someone later gives that name to another instruction of your organization, the old address leads to that one instead.
Move it to another workspace
You can move an instruction to another workspace you administer, in your organization or in another one.
Plans Community 1 · Pro 1 · Team unlimited · Enterprise unlimited
- Open the instruction's ⋯ menu and choose Move to another workspace….
- Under Where to, pick the workspace. Under Its name there, keep or change its short name.
- Press Move…. The editor shows what will change and asks again. Press Move it.
Its versions, people and followers go with it. It leaves its folder and project, and its old address keeps pointing at it. The toast says "Moved to …" with its new address, and Go there opens that workspace. If the instruction was open, the editor opens the other workspace for you.
Organizations and workspaces explains when you need more than one workspace.
Delete and restore
Choose Delete in an instruction's ⋯ menu. It goes to Trash, and the toast has Undo. Deleting a folder takes the instructions in it along. Deleting a project asks first, and says how many folders and instructions go with it.
Agents that follow a deleted instruction keep the last version they have, but get nothing new.
Trash keeps everything for 30 days. Then it is deleted for good.
- To bring something back, open Trash and press Restore. It goes back where it was. The toast says it is back.
- To delete it now, press Delete forever, then confirm. Its draft, versions and history are gone, and this can't be undone. Its address stays taken for a year, so no other instruction shows up there.
See what changed: Updates and Analytics
Two more pages give an overview of your instructions. Open the command palette (Ctrl+K, or ⌘K on a Mac) and choose one:
- Updates: what changed across your instructions, newest first. Each row says where it is, when it was edited and which version is live. Press a row to open it.
- Analytics: how many instructions you have, how many are live, how many are favorites and how many folders there are. The Agents' reads part doesn't show figures yet.
To see which agents follow one instruction, read See which agents follow an instruction.
If it doesn't work
| What you see | What to do |
|---|---|
| "There is no project or folder to move it to yet: make one with New folder." | Make a project or a folder first, then choose Move to… again. |
| "You administer no other workspace to move it to …" | You need to be an admin of another workspace. Make one with New workspace or New organization in the side bar's menu at the top. |
| "There is already a folder named … here." | Choose another name. Two folders in the same place can't share a name. |
| "A folder can't go inside itself." | Drop the folder somewhere outside it. |
| "… it is under legal hold and can't leave its organization" | Your organization keeps this instruction for legal reasons. Ask your organization's admins. |
| "sealed instructions don't move between workspaces yet" | A sealed instruction stays in its workspace for now. |
| Change its address…, Archive or Move to another workspace… isn't in the menu | Only the instruction's Admins see them, and only when you are signed in. Ask an Admin, or ask for access. |
| Still stuck | Write to us on Support. |
Questions
Does archiving stop my agents?
No. An archived instruction is read-only, but agents keep following its published versions. Unarchive it to change it again. See Archive an instruction.
What happens to agents when I delete an instruction?
They keep the last version they have, but get nothing new. If you restore it from Trash within 30 days, it is as it was. See Delete and restore.
Will links to the old address break after I change it?
No. The old address keeps pointing at the instruction. It changes only if someone gives that old name to another instruction of your organization. See Change its address.
What is the difference between Rename and Change its address?
Rename… changes the name people see on cards and in the editor. Change its address… changes the short name in its web address, which agents and links use. See Rename, duplicate or move an instruction.
Why doesn't search find my instruction?
The search on the Instructions page looks only at names. Press Ctrl+P (⌘P on a Mac) and type a few words about it: signed in, it also finds instructions by meaning. See Find an instruction.