Metadata-Version: 2.4
Name: mountctl
Version: 0.1.0
Summary: Mount connector setup CLI
Author: Mount
License: Proprietary
Keywords: agent,cli,connector,mount
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# mountctl

`mountctl` is the Mount local exploration CLI.

MVP usage:

```bash
pipx run mountctl explore <KEY> "<ENTRY_COMMAND>"
```

Example:

```bash
pipx run mountctl explore mnt_abc123 "opencode run"
```

The `explore` command starts a Mount-hosted setup agent and serves local read-only tool calls while it inspects the current directory. `mountctl` does not use hardcoded file-name, model-name, tool-name, or guardrail heuristics. The hosted agent decides what to inspect and finishes by calling `upload_agent_info`.

It does not execute the entry command, start the target agent, install packages, edit files, or create `.mount/`.

## Local development

```bash
python -m pip install -e .
mountctl explore dev_key "opencode run"
```

Useful options:

```bash
mountctl doctor
```

## Local Tools

- `list_dir`
- `read_file`
- `list_env_names`
- `read_env_value`
- `dtap_tool_list`
- `upload_agent_info`

The file tools are read-only and constrained to the current working directory. `mountctl` never executes the entry command and never writes local files.

## API Integration

`mountctl` connects to Mount's setup agent using the built-in API URL: `https://mount-backend-production.up.railway.app`.

```bash
mountctl explore <KEY> "<ENTRY_COMMAND>"
```

For local development or staging, `MOUNT_API_URL` can override the built-in API URL.
