Metadata-Version: 2.4
Name: archway
Version: 0.3.0
Summary: Command-line client for Archway services
Project-URL: Homepage, https://archway-labs.ai
Author: Archway Labs
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: archway,cli,developer-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.12
Requires-Dist: certifi>=2025.1.31
Requires-Dist: mcp<3,>=2
Description-Content-Type: text/markdown

# Archway

`archway` is the lightweight command-line client for an Archway service.
It contains no translation engine, analysis engine, or server implementation.

## Installation

Install the command into an isolated environment:

```bash
pipx install archway
```

## Configuration

Set the service URL and personal bearer token:

```bash
export ARCHWAY_URL="https://your-archway-service.example.com"
export ARCHWAY_TOKEN="<personal token>"
```

The health check does not require a token:

```bash
archway health
```

Discover the installed client's current commands and agent guidance:

```bash
archway --help
archway agent-guide
archway capabilities --format json
```

Translate one Python file:

```bash
archway translate example.py
```

Specify its dotted module name and write the IR response to a file:

```bash
archway translate src/example.py \
  --module-name package.example \
  --output example.ir.json
```

## MCP server

Run a local stdio MCP adapter for agent hosts:

```bash
archway mcp serve
```

The MCP host launches this command as a child process. It exposes capability discovery,
service health, and Python translation tools backed by the same configured Archway Engine
Service as the CLI. It does not listen on a port or contain the engine itself.

The host must provide `ARCHWAY_URL` and `ARCHWAY_TOKEN` to the process. Do not put the
token in command arguments or commit it in a host configuration file.

Command output is JSON. Errors are written to standard error and do not include the
configured bearer token.
