- name
Register the Agent Sessions plugin in a NocoBase App so people talk in the browser with the coding agents on their own computers (Codex, Claude Code, Gemini CLI, GitHub Copilot, Cursor, OpenCode and m
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add nocobase/nocobase --skill nocobase-app-plugin-agent-sessions -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add nocobase/nocobase --skill nocobase-app-plugin-agent-sessions -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add nocobase/nocobase --skill nocobase-app-plugin-agent-sessions -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add nocobase/nocobase --skill nocobase-app-plugin-agent-sessions -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/nocobase/nocobase/tree/HEAD/packages/plugins/app-plugin-agent-sessions/skills/nocobase-app-plugin-agent-sessionsFrom the publisher
Use this Skill when an App lets people hold conversations in its pages with the coding agents on their own computers, keeping the transcripts and the work those conversations create in the App. Do not use it for agents that run the team's work on runners; that is nocobase-app-plugin-agents.
The package README is the full reference: read it at node_modules/@nocobase/app-plugin-agent-sessions/README.md (in this repository, packages/plugins/app-plugin-agent-sessions/README.md).
@nocobase/app-cli-client, which has acp start. Pass the CLI's name and install command to agentSessionsRoute({ cli, install }) so the page can tell people how to connect a computer.agentSessionsToken: registerLinkKind(kind, { resolve, start, search, progress }) says how a record stands for a viewer, starts its work, finds the records a person mentions with #, and tells the agent how each is going (the session work CLI command); registerProjects({ list }) names the projects a session may work for; registerNotices({ send, settle }) tells the App what the owner should hear of while not looking at a session (the agent waits for permission, a turn ended or failed), for its inbox; registerInstructions(text) tells every session's agent how the App wants it to work, such as recording development as issues instead of doing it, in its first message and again when the text changes. Do all of it from a service provider's boot.status gives icon (backlog, started, blocked, review, done, closed) and needsYou (what it waits on the viewer for) beside label and tone, so the page draws the App's own status shapes and counts what waits. agentSessionsRoute({ cli, linkPanels: { <kind>: Component } }) opens a kind's records beside the conversation (LinkPanelProps, ?<kind>=<refId> in the address) instead of at their href.agentSessionImages) and served to their owner by the plugin; register the file plugin, or images stay in the transcript as sent.resolve answers only what the viewer may see, in viewer.locale. start acts as the viewer; refuse what they may not do there rather than here.agent-full-access or Claude Code bypassPermissions, or else every permission allowed by the bridge), in the folders the person allows for the computer: the whole home directory by default, or those they add by browsing it in "My computers". --root on acp start is only a hard limit on the computer. Do not add a read-only default.{ routes: false } when the App places the page itself: spread agentSessionsRoute({ cli, install }) into the App's routes with its navigation entry.agentSessionsToken from @nocobase/app-plugin-agent-sessions/server and register the App's link kinds and tools.<cli> login --server <url>) and runs <cli> acp service install on their computer, which keeps it connected from every login (<cli> acp start connects it until the terminal stops). The first registration gives the computer its own key, so it stays connected however long the sign-in lasts.The page list has fold and expand controls, with per-viewer choices by width band. Hosts sharing a sidebar with another conversation kind can use the exported useSessionsLayout hook and pass the same layoutStoragePrefix in the route options. Compact embedded panel headers keep their own styling.
Hosts embedding AgentSessionsPanel can use attach.mode: 'replace' with a stable scope and a fresh update id to follow page context in a new draft. A new explicit entry starts another scope. Automatic context replaces only its own attachments and stops following after removal or submission; manual mentions, images and attachments survive page changes. Use activeLink to mark the host page's current record in the sidebar's internal task list; sidebar task links keep that list open without a page overlay.
Queued messages support individual withdrawal with bridge protocol 4. The server arbitrates withdrawal against execution before agent initialization, and the UI waits for computer removal confirmation before showing Withdrawn. Offline withdrawal remains pending. Upgrade and restart older computer connections; messages already delivered to an older bridge explicitly have no safe withdrawal capability. Editing a withdrawn message opens a separate draft and retains its images, without replacing the current draft. Do not replace this protocol with session cancellation or client-only hiding.
Session startup and restore require the CLI’s bundled shared Skill. Unsupported agents or Skill installation failures stop the opening with a message; no repository files or session credentials are created.
© 2026 Skills Rack.
---name: nocobase-app-plugin-agent-sessionsdescription: Register the Agent Sessions plugin in a NocoBase App so people talk in the browser with the coding agents on…---# packages/plugins/app-plugin-agent-sessions/skills/nocobase-app-plugin-agent-sessions/SKILL.mdOverview
Register the Agent Sessions plugin in a NocoBase App so people talk in the browser with the coding agents on their own computers (Codex, Claude Code, Gemini CLI, GitHub Copilot, Cursor, OpenCode and more, on macOS, Linux or Windows; `<cli> acp service install` or `acp start`), route its page, tie the App's records to sessions with a link kind (registerLinkKind) that people can also mention with `#`, let sessions work for the App's projects (registerProjects), tell the agents how to work (registerInstructions), notify the owner (registerNotices), work out why a computer is offline, an agent is unavailable or a session's agent cannot reach the tools.
FAQ
Download packages/plugins/app-plugin-agent-sessions/skills/nocobase-app-plugin-agent-sessions/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/nocobase/nocobase.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.