Skill: archibald80000-ai/cli-agent-bridge (version 0.2.1)

--- name: cli-agent-bridge description: Public ClawHub text release for a Windows companion skill that bridges local AI CLIs and controlled workspace file operations. This release documents the capability and setup path, but does not include the local PowerShell execution layer. --- # CLI Agent Bridge (Windows Companion) This directory is the public ClawHub text release of `cli-agent-bridge`. It is designed for: - ClawHub listing and skill discovery - OpenClaw skill description and usage guidance - explaining how the local companion deployment works It is not a self-contained runtime package. ## What this published release includes - skill metadata for ClawHub and OpenClaw discovery - public documentation - reference notes for provider behavior, file operations, and approval rules ## What this published release does not include - PowerShell executors - batch launchers - local install scripts - local test scripts - embedded AI provider binaries Uploading this directory does not automatically give the user: - a PowerShell execution layer - local `gemini`, `claude`, or `codex` - workspace file read/write execution ## Intended capability of the local companion deployment The full local companion deployment is intended to provide: - local AI CLI bridging for `gemini`, `claude`, and `codex` - controlled workspace `read`, `list`, and `exists` - approval-gated `mkdir`, `write`, and `append` - prompt loading from files for long or special-character input ## Provider status This published text release does not execute providers by itself. In the local companion deployment: - `gemini`: locally validated - `codex`: locally validated - `claude`: adapter path exists, but real availability depends on the user's local Claude CLI authentication and quota ## Filesystem boundary The published text release does not grant filesystem access by itself. In the local companion deployment, filesystem actions are intended to stay inside a configured workspace root and require explicit approval for write-like operations. ## Local companion requirement Users who want the complete runnable experience need the local companion deployment from: ```text <repo-root>/cli-agent-bridge ``` That local directory contains the Windows executors and local OpenClaw integration scripts that are intentionally excluded from this public upload directory.

path: PUBLISH-TO-CLAWHUB.md
content: # Publish To ClawHub

This directory is prepared as a web-upload-friendly public release of `cli-agent-bridge`.

## Why this directory is publishable

This package keeps only text files that explain the skill and its local companion model.

It intentionally excludes executable runtime files such as PowerShell and batch launchers so the published package does not promise behavior that the upload directory cannot provide by itself.

## Files kept in this directory

- `SKILL.md`
- `README.md`
- `PUBLISH-TO-CLAWHUB.md`
- `references/auth-model.md`
- `references/fs-operations.md`
- `references/provider-commands.md`

## Files that should not be uploaded

Keep these in the local full package, not in the public web upload directory:

- `*.ps1`
- `*.bat`
- local install scripts
- local verification scripts
- local test notes
- historical reports
- temporary test directories

## Suggested publish form values

- slug: `cli-agent-bridge`
- display name: `CLI Agent Bridge (Windows Companion)`
- version: `0.3.0`
- tags: `windows`, `openclaw`, `local-cli`, `powershell`, `companion`
- changelog: `First public text release for ClawHub. Documents the local Windows companion deployment and its capability boundaries without bundling executors.`

## Why `0.3.0` instead of `1.0.0`

`0.3.0` is the recommended public version because:

- the public release shape is now clear
- the uploaded package is documentation-first, not a self-contained runtime
- real `claude` availability still depends on each user's local Claude CLI authentication and quota

## Provider wording guidance

Public docs should state:

- this published directory does not execute providers by itself
- the local full package is intended to support `gemini`, `codex`, and `claude`
- `gemini` and `codex` were validated in the local full package
- `claude` depends on the user's local authentication and quota state

## Publish checklist

- only text files remain in the upload directory
- no `.ps1` files remain
- no `.bat` files remain
- `SKILL.md`, `README.md`, and this file use the same capability boundary
- no local absolute paths remain
- no account IDs, tokens, or secrets remain
- the package does not claim that executors are bundled
- the package does not claim open-ended filesystem access

## Recommended upload directory

Upload this directory:

```text
<repo-root>/clawhub/cli-agent-bridge
```


path: README.md
content: # CLI Agent Bridge (Windows Companion)

`cli-agent-bridge` is a public ClawHub text release for a Windows-focused OpenClaw companion skill.

Its purpose is to describe a local skill that can bridge:

- already-installed local AI CLIs
- controlled workspace file operations

This upload directory is documentation-first. It does not contain the local PowerShell execution layer.

## Typical use cases

- answer through a local `gemini` CLI
- answer through a local `codex` CLI
- answer through a local `claude` CLI when the user's local Claude CLI is authenticated and has available quota
- describe a guarded local file read/write workflow for OpenClaw

## Current support status

This published directory does not execute anything by itself.

The local companion deployment is intended to support:

- `gemini`: locally validated in the full local package
- `codex`: locally validated in the full local package
- `claude`: local adapter path exists, but real use depends on the user's Claude CLI authentication and quota

## Public release vs local full package

This directory is the public ClawHub release:

- text-only
- safe to upload through a web-based skill publisher
- meant for listing, discovery, and capability explanation

The full local package lives at:

```text
<repo-root>/cli-agent-bridge
```

That local package contains:

- PowerShell executors
- batch helpers
- local install and verification scripts
- the actual runtime behavior for provider execution and guarded filesystem actions

## Important limits

Uploading this directory does not automatically provide:

- `.ps1` or `.bat` executors
- direct access to local `gemini`, `claude`, or `codex`
- automatic workspace file access
- automatic approval handling for writes

Any real provider execution or filesystem mediation depends on a separate local deployment of the full package.

## Filesystem and safety notes

In the full local package, filesystem behavior is intended to be restricted to a workspace root, with explicit approval required for write-like actions.

This public text release does not itself grant read or write access to any project directory.

## If users want the full runnable experience

They should deploy the local full package from:

```text
<repo-root>/cli-agent-bridge
```

Then they can wire that local package into their own OpenClaw or private Windows environment.

## Included public docs

- `SKILL.md`
- `PUBLISH-TO-CLAWHUB.md`
- `references/provider-commands.md`
- `references/fs-operations.md`
- `references/auth-model.md`


path: references/auth-model.md
content: # Approval Model Reference

This file describes the approval model of the local full package of `cli-agent-bridge`.

It applies to the local runtime package, not to this public text-only release by itself.

## Intended approval rules in the local full package

No approval intended:

- AI-only execution
- `read`
- `list`
- `exists`

Explicit approval intended:

- `mkdir`
- `write`
- `append`

## Permanent restrictions

Even with approval, the local full package is intended to block:

- writes outside the configured workspace root
- delete operations
- move operations
- rename operations

## Important note

This published directory documents the model, but does not contain the executor that performs approval checks.


path: references/fs-operations.md
content: # Filesystem Operations Reference

This file describes the guarded filesystem model used by the local full package of `cli-agent-bridge`.

It is not a promise that the public ClawHub upload directory can read or write files by itself.

## Intended local behavior

In the local full package, filesystem actions are intended to stay within a configured workspace root.

Expected action surface:

- `read`
- `list`
- `exists`
- `mkdir`
- `write`
- `append`

Blocked actions in the local full package:

- `delete`
- `move`
- `rename`
- writes outside the configured workspace root

## Approval boundary

In the local full package:

- `read`, `list`, and `exists` are intended to run without approval
- `mkdir`, `write`, and `append` are intended to require explicit approval

## Important note

The public ClawHub release documents this model, but does not ship the runtime layer that enforces it.


path: references/provider-commands.md
content: # Provider Commands Reference

This file describes the command model used by the local full package of `cli-agent-bridge`.

It is reference material for the public ClawHub release only.

This published directory does not execute any provider command by itself.

## Intended local provider model

The local full package is intended to bridge these already-installed commands:

- `gemini`
- `claude`
- `codex`

## Intended provider status in the local full package

- `gemini`: locally validated
- `codex`: locally validated
- `claude`: adapter path exists, but real availability depends on the user's local Claude CLI authentication and quota

## Command style used by the local full package

- `gemini`: one-shot prompt execution
- `claude`: non-interactive print-style execution when the local CLI supports it
- `codex`: non-interactive `exec`-style execution when the local CLI supports it

## Important note

Users need the local full package and their own installed provider CLIs for any of this behavior to exist at runtime.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)