Metadata-Version: 2.4
Name: am-i-vibing
Version: 1.0.0
Summary: Installer for the cmdop CLI — one AI agent, running on your own machines
Project-URL: Homepage, https://cmdop.com
Project-URL: Documentation, https://docs.cmdop.com
Project-URL: Download, https://cmdop.com/download
Project-URL: Source (organization), https://github.com/commandoperator
License: MIT
Keywords: agent-runtime,ai-agent,cli,cmdop,developer-tools,installer,self-hosted
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# am-i-vibing

![cmdop — messenger for AI agents](https://raw.githubusercontent.com/commandoperator/assets/b72b9ac6c796b958a038f684b323c7be49a49c9d/promo/social.webp)

**Installer for the [cmdop](https://cmdop.com) CLI** — an agent with a machine under it, not a tab.

```bash
pip install am-i-vibing
am-i-vibing
```

That's it. `am-i-vibing` detects your platform, downloads the `cmdop` binary,
verifies it against the published checksums, installs it, and hands over.

> **Not affiliated with the am-i-vibing project.** If you are looking for
> [github.com/ascorbic/am-i-vibing](https://github.com/ascorbic/am-i-
> vibing), that is a different project — this package will not install it.
> This package is published by CMDOP and installs the `cmdop` CLI.

Most AI coding help lives in an editor or a browser tab, and stops at the edge of it. The moment the useful next step is on a different machine, the conversation turns into instructions for you to carry out.

`cmdop` runs the agent on the machine itself, so the next step is something it can take. This package installs it.

**How does CMDOP compare?**
[CMDOP Skills vs OpenClaw: two approaches to AI agent skills →](https://docs.cmdop.com/blog/cmdop-skills-vs-openclaw)

## Doing it beats describing it

The difference between an assistant that suggests a command and one that can run it is not intelligence, it is access — and access is a deployment question, not a model question.

Nothing runs until you ask. The package installs a binary and exits; what happens after that is a command you type.

## What is cmdop

One executable that is the agent, the relay, the local server and the web
console at once. There is no gateway, backend, database server or broker to
stand up — you add one binary to a machine you already own.

- run an AI agent on your own machine, with your own tools
- reach it from anywhere: terminal, files, remote execution
- connect machines into a fleet
- works with Claude Code and other agent engines under the hood

Full documentation: **[docs.cmdop.com](https://docs.cmdop.com)**

## Usage

```bash
am-i-vibing                    # install cmdop (if needed), then run it
am-i-vibing --install-only     # install, don't hand over
am-i-vibing --prefix ~/bin     # choose the install directory
am-i-vibing --force            # reinstall even if already present
am-i-vibing --quiet            # print only the installed path
am-i-vibing -- --help          # everything after `--` goes to cmdop
```

Default install directory is `~/.local/bin` (`%LOCALAPPDATA%\cmdop\bin` on
Windows). No `sudo`, no system directories.

## What it does, precisely

1. Detects your OS and architecture.
2. Fetches `SHA256SUMS` from `install.cmdop.com`.
3. Downloads the matching binary to a temporary file.
4. **Verifies the SHA-256 against the published checksum.** On mismatch it
   aborts and installs nothing.
5. Moves the verified binary into the install directory and marks it
   executable.
6. Runs it.

Supported: macOS (Apple Silicon, Intel), Linux (x64, arm64), Windows (x64).

## What it does not do

- **No side effects at install time.** `pip install am-i-vibing` only unpacks
  files. Nothing is downloaded or executed until you run `am-i-vibing`.
- **No network access on import.** `import am_i_vibing` touches nothing.
- **No telemetry.** The package sends no analytics, ever.
- **No dependencies.** Standard library only, so there is nothing to conflict
  with what you already have installed.

## Python API

The installer is importable if you would rather script it:

```python
import am_i_vibing

target = am_i_vibing.detect()
print(target.label, target.asset)

result = am_i_vibing.install()
print(result.path, result.sha256)
```

`am_i_vibing.install()` raises `am_i_vibing.InstallError` with a user-facing message
on any failure, and `am_i_vibing.UnsupportedPlatform` when there is no published
binary for the current machine.

## Links

- Website — <https://cmdop.com>
- Documentation — <https://docs.cmdop.com>
- Downloads — <https://cmdop.com/download>

## License

MIT
