cli-agent-bridge

# 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 OpenCla...

# 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 explici...