Metadata-Version: 2.4
Name: cyborgy
Version: 0.1.1
Summary: Extend the claude and codex CLIs: skills marketplace, memory, and extension APIs via the Cyborgy MCP.
Author: Kizuna Intelligence
Project-URL: Homepage, https://github.com/kizuna-intelligence/cyborgy
Project-URL: Repository, https://github.com/kizuna-intelligence/cyborgy
Keywords: cyborgy,codex,claude,mcp,skills,agents
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2
Requires-Dist: pynacl>=1.5
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: twine>=5; extra == "dev"

# Cyborgy CLI

`cyborgy` extends coding-agent CLIs such as Claude Code and Codex with the
Cyborgy MCP, workspace roles, skills, memory, extension APIs, and temporary
tunnels.

This package provides:

- `cyborgy`: the main CLI.
- `cyborgy-mcp`: the MCP server used by supported coding agents.
- `cyborgy-dev` and `cyborgy-mcp-dev`: development-environment entry points.

## Install

```bash
pip install cyborgy
```

For local Cyborgy development tooling:

```bash
pip install "cyborgy[dev]"
```

## Basic usage

```bash
cyborgy login
cyborgy mcp install --target codex
cyborgy codex exec "summarize this repository"
```

The CLI stores login state locally, installs the Cyborgy MCP configuration into
the current repository, and syncs the skills assigned to that workspace.

## Worker auto-update

`cyborgy worker` can opt into pip package auto-updates:

```bash
CYBORGY_WORKER_AUTO_UPDATE=1 cyborgy worker
```

When enabled, the worker periodically checks the installed `cyborgy` package
against PyPI. If a newer version exists, it runs `python -m pip install
--upgrade cyborgy` in a waited subprocess. After a successful install, the
worker stops polling for new commands, lets any current agent subprocess finish,
and re-execs itself at the next idle boundary. It does not broad-kill processes
or interrupt running agent commands.

To keep a development-extra install on the same release track, start the worker
with `CYBORGY_WORKER_AUTO_UPDATE_PACKAGE=cyborgy[dev]`. Version checks still use
the `cyborgy` distribution on PyPI, while pip upgrades the configured package
spec (`cyborgy` by default, or `cyborgy[dev]` when requested).

Optional knobs:

- `CYBORGY_WORKER_AUTO_UPDATE_INTERVAL`: seconds between checks, minimum 60.
- `CYBORGY_WORKER_AUTO_UPDATE_INITIAL_DELAY`: seconds before the first check.
- `CYBORGY_WORKER_AUTO_UPDATE_TIMEOUT`: seconds before the pip install attempt times out.
- `CYBORGY_WORKER_AUTO_UPDATE_PACKAGE`: pip package spec, default `cyborgy`.
- `CYBORGY_WORKER_AUTO_UPDATE_INDEX_URL`: pip index URL for installation.

## Status

This is an alpha package. The public CLI surface is expected to evolve with the
Cyborgy service.
