unoplat-code-confluence-cli
Use the Unoplat Code Confluence CLI to run the local app, configure providers, add repositories, and generate AGENTS.md artifacts with automatic PR publication. Trigger when users mention Unoplat, Code Confluence, repository setup, AGENTS.md generation, or agent-md workflows.
unoplat · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add unoplat/unoplat-code-confluence --skill unoplat-code-confluence-cli技能说明
name: unoplat-code-confluence-cli description: "Use the Unoplat Code Confluence CLI to run the local app, configure providers, add repositories, and generate AGENTS.md artifacts with automatic PR publication. Trigger when users mention Unoplat, Code Confluence, repository setup, AGENTS.md generation, or agent-md workflows." metadata: version: "0.1.0"
Unoplat Code Confluence CLI
Use the ucc CLI to manage the local Unoplat Code Confluence app, add repositories, open setup pages, and generate or update AGENTS.md artifacts after refreshing latest code.
Capabilities
- Starts, updates, stops, or destroys the local Unoplat Code Confluence Docker Compose stack.
- Opens repository-provider and model-provider setup pages in the local frontend.
- Adds a repository from an HTTPS or SSH git remote URL without running ingestion.
- Starts AGENTS.md generation/update after refreshing latest code.
- Relies on the backend workflow to publish a pull request automatically when AGENTS.md generation completes.
- Emits JSON results that agents can summarize for users.
When to Use
Use this skill when the user asks to:
- Use Unoplat Code Confluence or the
uccCLI. - Start, stop, update, or reset the local Code Confluence app.
- Configure repository-provider tokens or model providers for Code Confluence.
- Add, track, import, or onboard a repository into Code Confluence.
- Generate, update, refresh, or publish AGENTS.md artifacts for a repository.
- Run
agent-mdfor a repository.
Command Availability
Always use a trusted ucc executable installed on the user's PATH. If ucc is not available, help the user install it on PATH with uv tool install.
1. Check for ucc
ucc --help >/dev/null 2>&1 && echo "UCC_AVAILABLE" || echo "UCC_NOT_FOUND"
If available, run commands as:
ucc <command>
2. If ucc is not available, check for uv
uv --version >/dev/null 2>&1 && echo "UV_AVAILABLE" || echo "UV_NOT_FOUND"
If uv is available, ask for user approval and then install the CLI on PATH:
uv tool install "git+https://github.com/unoplat/unoplat-code-confluence.git#subdirectory=unoplat-code-confluence-cli"
ucc --help
After installation, run all commands as ucc <command>. The package requires Python >=3.13; let uv resolve the tool environment.
3. If neither ucc nor uv is available
Stop and ask the user to install a prerequisite. Do not install uv, run remote installer scripts, or mutate the user's Python environment automatically.
Tell the user:
The Unoplat CLI is not available, and uv is not installed.
Please install uv from the official documentation and retry:
https://docs.astral.sh/uv/getting-started/installation/
Then install the CLI on PATH:
uv tool install "git+https://github.com/unoplat/unoplat-code-confluence.git#subdirectory=unoplat-code-confluence-cli"
Repository URL Requirements
For repository add and AGENTS.md operations, use the repository git remote URL. Acceptable forms include:
https://github.com/owner/repo.git
git@github.com:owner/repo.git
Rules:
- The URL must end with
.git. - Prefer
git remote get-url originwhen operating inside the target repository. - If the repository URL is ambiguous or missing, ask the user before proceeding.
Workflows
In the examples below, ucc is expected to be installed on PATH. If it is not, follow the Command Availability instructions above to install it with uv tool install.
Start or Prepare the Local App
Use when the user asks to start Code Confluence or before setup/repository operations if the service may not already be running.
ucc service run
This starts the pinned local app release and installs the latest Unoplat Code Confluence app release on first run. The CLI resolves app releases from GitHub tags matching unoplat-code-confluence-vMAJOR.MINOR.PATCH; component releases and arbitrary version selection are not part of the CLI workflow. It may fetch GitHub release metadata and pull Docker images.
Prerequisites:
- Docker daemon / Docker Desktop is running.
- Docker Compose support is available.
- Network access is available for first install/update and image pulls.
Summarize the JSON result, especially installed_tag, available_tag, update_available, installed_release, and warnings.
Update the Local App
Ask for confirmation before updating unless the user explicitly requested an update. Updates always target the latest GitHub app release whose tag matches unoplat-code-confluence-vMAJOR.MINOR.PATCH; do not ask the user to choose a historical version.
ucc service update
Summarize the previous_tag, installed_tag, available_tag, and warnings.
Stop the Local App
Safe stop without deleting volumes:
ucc service stop
Destroy the Local App
Destructive: deletes Docker Compose volumes. Only run after explicit user confirmation.
ucc service destroy
Warn the user that local app volumes/data will be removed.
Check Setup Status
Use this to verify repository-provider and model-provider setup without exposing secrets:
ucc service status
The CLI verifies the repository-provider token through Flow Bridge's /user-details endpoint for the configured provider, and verifies model-provider configuration through Query Engine's /v1/model-config endpoint. It reports only setup status, provider/model identifiers, and whether a model credential exists.
Configure Repository Provider Token
Before adding repositories, ensure repository-provider token setup is complete:
ucc setup token-repo-provider
This ensures the local app is running and opens the setup page in the user's browser. Ask the user to complete the browser flow before continuing.
Default frontend URL:
http://127.0.0.1:3000/onboarding
Configure Model Provider
Use when the user needs model-provider setup:
阅读完整来源 ↗