diff --git a/AGENTS.md b/AGENTS.md index 221d9883d..d9a894c26 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -38,3 +38,25 @@ solely for version selection or skipping a cancelled, never-public candidate. Preparation, review, and draft-only requests do not authorize public publication. All CI, independent review, environment, artifact, draft/promotion, and immutable tag requirements remain mandatory. + +## Where things live (repositories and sites) + +- `777genius/universal-agent-plugins` (this repo): CLI (`cli/`, `install/`), + landing (`landing/`, https://universal-agent-plugins.com/), public docs source + (`website/`, https://universal-agent-plugins.com/docs/en/). +- `777genius/universal-agent-plugins-registry`: signed directory feeds + (`catalog/`, `registry/`). Its old site (`site/`) is retired: + https://777genius.github.io/universal-agent-plugins-registry/ shows a + "has moved" notice. +- The Directory (plugin list and install buttons) is `landing/pages/plugins/` + in this repo, published at https://777genius.github.io/universal-agent-plugins/plugins/. +- The landing build verifies the registry's signed feeds with + `cmd/agentplugins-registry-mirror`, so Directory data follows the registry. +- Install buttons in the Directory and the landing catalog must match the + source kinds the released CLI accepts. Check `agentplugins skills add --help` + (or the release notes) before changing them. +- Public docs are published only for `index`, `use/*`, `build/*`, + `guide/quickstart`, `reference/client-compatibility` and the authoring API. + Other `website/source/en` pages are archived and not published. +- Pages under `use/` and `build/` are journey pages. They need released status + and routes in all five maintained locales (`en`, `ru`, `es`, `fr`, `zh`). diff --git a/README.md b/README.md index 3e0b77284..11a72e939 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ Install and manage Agent Plugins 1.0 across your AI agents with one CLI. **Keep a reproducible set of plugins and dependencies, and carry it to another computer.** The manifest records what you need; the lockfile pins the exact -packages to restore. This workflow is **SOURCE ONLY / UNRELEASED**; see +packages to restore. This workflow ships in the published CLI; see [Restore your plugin setup](#restore-your-plugin-setup). For the published installer, start with the [Quick start](#quick-start). @@ -137,9 +137,8 @@ selected agent. ## Restore your plugin setup -**SOURCE ONLY / UNRELEASED:** these commands require a compatible CLI built from -current source. The published CLI is not qualified for this workflow; the -[Quick start](#quick-start) above covers released installation. +These commands are part of the published CLI (`agentplugins` 0.1.90 and later). +The [Quick start](#quick-start) above covers installation. On the source computer, open a folder to use for the transfer and run: @@ -162,12 +161,13 @@ Codex, OpenCode, Cursor and Gemini CLI. Authentication, client settings, secrets and plugin data need separate setup or backup. Transferring the files does not guarantee offline installation. -See [Restore on another machine](docs/UAP_DEPENDENCIES.md#restore-on-another-machine) +See [Restore on another machine](https://universal-agent-plugins.com/docs/en/use/manage.html#restore-on-another-machine) for confirmation prompts, supported restore behavior and recovery. -Source-build development: [install raw Agent Skills from GitHub or compatible HTTPS publishers](docs/AGENT_SKILLS_INSTALLER.md), -including the local browser picker and versioned saved dependencies. This does not -claim availability in an already published installer release. +[Install Agent Skills](docs/AGENT_SKILLS_INSTALLER.md) with `agentplugins skills add` +from a GitHub repository or from an HTTPS publisher that serves a `.well-known` +Skills index. Publisher installs take an exact `--skill` name. The local browser +picker and saved dependencies are included. ## Any Agent Plugins 1.0 package diff --git a/docs/UAP_DEPENDENCIES.md b/docs/UAP_DEPENDENCIES.md index 29d51c3fc..ad2ce1ccc 100644 --- a/docs/UAP_DEPENDENCIES.md +++ b/docs/UAP_DEPENDENCIES.md @@ -1,7 +1,8 @@ # UAP dependency environments -**Unreleased:** this workflow is available in current source and has not been -qualified as a published CLI release. +**Released:** this workflow ships in the published CLI (`agentplugins` 0.1.90 and +later). The restore guide is on the docs site: +[Restore on another machine](https://universal-agent-plugins.com/docs/en/use/manage.html#restore-on-another-machine). `agentplugins deps` manages one current-user environment in `AGENTPLUGINS_HOME` (default: `os.UserConfigDir()/agentplugins`). `uap.toml` records intent and `uap.lock` records exact @@ -237,8 +238,8 @@ repair keeps its existing signed-policy rules. ### Restore on another machine -Use a compatible CLI built from current source; the transfer commands below -remain unreleased. In the folder you want to carry to another machine, run: +The transfer commands below ship in the published CLI. In the folder you want to +carry to another machine, run: ```sh agentplugins deps export diff --git a/landing/components/registry/RegistryRestore.vue b/landing/components/registry/RegistryRestore.vue index 61978cdfb..97dde3b0c 100644 --- a/landing/components/registry/RegistryRestore.vue +++ b/landing/components/registry/RegistryRestore.vue @@ -1,5 +1,6 @@