Skip to content

docs: add comprehensive plugin authoring and management guides #66

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
sanchitrk wants to merge 5 commits into from
Closed

docs: add comprehensive plugin authoring and management guides #66

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
f768e72
docs(www): add plugins section
claude Oct 10, 2026
872ac10
docs(www): note plugin trust, use pnpm wording
claude Oct 10, 2026
fbdb7b7
docs(www): reuse shared Placeholder component in plugin pages
claude Oct 10, 2026
fa0a3fe
docs(www): correct plugin docs details against source
claude Oct 10, 2026
d513dab
docs(www): place plugins under a Customize group, add FAQ and related…
claude Oct 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
docs(www): note plugin trust, use pnpm wording 
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011TYMJKMx7fnbFmfjDukDze
  • Loading branch information
@claude
claude committed Oct 10, 2026
commit 872ac1076ab1a8579ea81105faa0cb8df01e12b6
6 changes: 6 additions & 0 deletions sites/www/content/docs/plugins/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,12 @@ A plugin is a JavaScript module that default-exports one plugin definition. You

Loading never touches the network. If a plugin is declared but not installed, CodeWork tells you to run `codework plugin install` instead of quietly fetching it. See [resolve-only loading](/docs/plugins/install#resolve-only-loading).

<Callout type="warn" title="Only install plugins you trust">
A plugin's code runs inside the CodeWork process with your user's access, and CodeWork has no permission prompts:
tools a plugin registers run without asking. CodeWork never runs install scripts, but the plugin itself is trusted
once it loads.
</Callout>

## Plugin kinds

Every plugin declares a `kind`, which is the part of the agent it extends. The kind also decides when it runs: all tool plugins are set up before any prompt plugin, so a prompt plugin always sees the complete tool set.
Expand Down
2 changes: 1 addition & 1 deletion sites/www/content/docs/plugins/install.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ Installed @acme/codework-tool-proc@1.2.0 (acme.tool.proc)
1 installed, 2 already present, 1 local
```

This is the plugin equivalent of `npm install` with no arguments. It writes nothing to settings, skips anything already in the store, and skips local paths, which are loaded where they are.
This is the plugin equivalent of `pnpm install` with no arguments. It writes nothing to settings, skips anything already in the store, and skips local paths, which are loaded where they are.

## Resolve-only loading

Expand Down