Metadata-Version: 2.4
Name: softwire
Version: 0.1.19
Summary: Local scripting bridges for controlling professional creative software from a shell agent.
Author: Creative Adapters
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: MacOS X
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Multimedia
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pywin32>=306; platform_system == "Windows"

<h1>Help your Humans with their Software</h1>

```bash
pip install softwire
softwire setup
```

**A tiny bridge that lets your coding harness drive professional desktop software — Photoshop, Premiere, Blender, Unity, and more — directly from the shell.**

SoftWire gives agentic harnesses — Codex, Claude Code, Gemini CLI, OpenCode and the likes — direct access to the scripting APIs inside professional desktop software. One `pip install softwire && softwire setup` covers many apps across Adobe Creative Cloud, Autodesk, Microsoft Office, and game engines.

[SoftWire is not an MCP server](https://github.com/SFKislev/Softwire/blob/main/docs/mcp.md). It is simpler. The agent sends a script through a small bridge command, the bridge runs it inside the app's own automation runtime, and the app returns JSON.

> agent shell → bridge command → app scripting runtime → JSON result

This is done without brittle screenshots and without schema definitions. The bridge exposes the scripting layer already built into each application.

## Installation

```bash
pip install softwire
softwire setup
```

This detects your harnesses and informs them that SoftWire exists. For first-run checks, source checkout commands, and app-specific prerequisites, see [Setup and commands](https://github.com/SFKislev/Softwire/blob/main/docs/setup.md).

## Adapters

A single SoftWire installation supports, out of the box, many applications. Agents should tell their humans if any app-specific setup is needed.

- [Adobe Photoshop](adapters/photoshop_adapter/APP.md)
- [Adobe Illustrator](adapters/illustrator_adapter/APP.md)
- [Adobe InDesign](adapters/indesign_adapter/APP.md)
- [Adobe Premiere Pro](adapters/premiere_adapter/APP.md)
- [Adobe After Effects](adapters/after_effects_adapter/APP.md)
- [Adobe Audition](adapters/audition_adapter/APP.md)
- [Blender](adapters/blender_adapter/APP.md)
- [Unity](adapters/unity_adapter/APP.md)
- [SideFX Houdini](adapters/houdini_adapter/APP.md)
- [Autodesk 3ds Max](adapters/3dsmax_adapter/APP.md)
- [Microsoft Word](adapters/word_adapter/APP.md)
- [Microsoft Excel](adapters/excel_adapter/APP.md)
- [Microsoft PowerPoint](adapters/powerpoint_adapter/APP.md)

## Harnesses

[See which files are edited upon installation](docs/harenesses.md)

- Claude Code
- Codex
- Copilot
- Cursor
- OpenCode
- OpenClaw
- Gemini CLI
- Qwen CLI
- Cline
- Kilo CLI

## More Docs

- [Setup and commands](https://github.com/SFKislev/Softwire/blob/main/docs/setup.md)
- [Harness support and discoverability](https://github.com/SFKislev/Softwire/blob/main/docs/harenesses.md)
- [Wait, isn't this called MCP?](https://github.com/SFKislev/Softwire/blob/main/docs/why-shell-adapters.md)

### Documentation for Agents

- [How the Adapters work](https://github.com/SFKislev/Softwire/blob/main/docs/ADAPTER_SPEC.md)
- [How to use the Bridge Contracts](https://github.com/SFKislev/Softwire/blob/main/shared/bridge-contract.md)
- [How to Work Together with a Human](https://github.com/SFKislev/Softwire/blob/main/shared/coexistence.md)
- [Known Issues](https://github.com/SFKislev/Softwire/blob/main/docs/known-issues.md)
