Skip to main content

​
What it is

A library entry is reusable fleet setup. It holds one or more immutable revisions, and each revision is a reviewed Definition with its required secrets, tools, and network hosts. The platform library is visible to every workspace. Your account’s entries are private to that account and can be reused across its workspaces.

​
Why it exists

The library lets a workspace reuse a setup that someone already reviewed.

​
How it behaves

Entries come only from reviewed chat drafts. Saving a fleet never publishes it, and publishing never creates a fleet. The dashboard has two tabs. All shows platform setups and setups published by your account. Workspace shows setups published by your account that this workspace can use. Private setups from other accounts never appear. An empty view shows a New fleet action. Start a fleet setup chat, then save or publish your setup. The library accepts reviewed Definitions. Older Markdown bundle entries were removed during the Definition rollout and do not appear. To reuse older instructions, paste them into a new setup chat and publish the reviewed result. Each new fleet starts from one pinned revision. A later revision of the entry does not change fleets saved from an earlier one. To move a fleet forward, improve it in a private chat and apply the reviewed change. agentsfleet library lists the gallery this workspace can use, which holds both tiers. TIER reads platform for an entry every workspace sees and tenant for one your account owns.
REVISION is the entry’s latest revision. Install a fleet shows how to save a fleet from it. A page with no entries reads No published Fleet libraries in this page. and shows how to publish one.

​
Publish an entry for your account

You publish from a reviewed draft. Publishing does not close the draft, so you can keep editing it. In the dashboard, open Publish to Fleet library under the chat’s setup and enter a Library name. Then choose Publish new entry, or Publish next revision for an entry this chat already published to. In the terminal, publish a reviewed draft with a label. <LABEL> is the display name, 1 to 100 characters. <DRAFT_ID> and <DIGEST> come from the draft’s review.
Inside an interactive chat, /publish <LABEL> does the same after a /review. To add a revision to an entry your account owns, add --publish-to <LIBRARY_ID> --library-etag <ETAG>. <ETAG> is the entry’s etag field from agentsfleet --json library list. A stale tag is refused, so the revision always follows the version you inspected. Publishing needs the library:write scope.

​
List and remove your account’s entries

agentsfleet library list lists only the entries your account owns. It never shows a platform entry.
agentsfleet library delete takes one identifier from the LIBRARY column.
Removal is permanent. The entry and its revision history leave the gallery, and nothing restores them.
A draft started from the entry, or published to it, stays. The draft loses its link to the entry and keeps its own content. You can remove only an entry your account owns. A platform entry, another account’s entry, or an entry already removed answers 404 with UZ-AUTHOR-001. All three answer the same way, so the reply never tells you whether an entry exists elsewhere. Removal needs the library:write scope. The dashboard lists the same entries at Fleet library in the workspace sidebar. Choose Inspect to read a revision, Older revisions for its history, or Start chat from this revision to open a private draft from it.

​
Platform entries

Platform entries come from a reviewed draft too. An operator whose session carries the platform-library:write scope stages the draft, and the entry starts hidden.
  1. In a workspace chat, open Publish to Fleet library and choose Stage platform entry.
  2. Open Fleet library under Platform.
  3. Edit the entry’s name, description, and the reason for each credential it needs.
  4. Choose Publish. Only published entries appear in workspace galleries.
Withdraw hides a published entry again. Only a withdrawn entry can be deleted. Existing fleets keep their pinned setup revision either way. The dashboard protects edits with the version the form loaded. If another operator saves first, your stale edit is refused. Refresh the row, review the newer values, and apply your change again.

​
Limits

A Definition’s description allows 32,768 characters, and so do its instructions. The first instructions a chat model writes allow 12,288 characters. The whole Definition allows 448 KiB of JSON. A Definition declares at most 128 tools, 64 secrets, and 64 network hosts. A tool name allows 128 characters, a secret name 128, and a network host 255. Library lists return 100 entries per page at most. Use --starting-after <CURSOR> with the cursor the previous page prints. Removing a fleet does not remove its library entry. Remove the entry itself with agentsfleet library delete <LIBRARY_ID>.