Metadata-Version: 2.4
Name: omnira
Version: 0.1.0
Summary: Command-line interface for the Omnira Lead Engagement Platform
Project-URL: Homepage, https://omnira.so
Project-URL: Documentation, https://docs.omnira.so/cli
Author-email: Omnira <support@omnirasystems.com>
License: Proprietary
License-File: LICENSE
Keywords: ai-agent,cli,leads,omnira,outreach,sales
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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 :: Communications
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Requires-Dist: certifi>=2023.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.7.0
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
Requires-Dist: typer>=0.12.0
Description-Content-Type: text/markdown

# Omnira CLI

The command-line interface for the [Omnira Lead Engagement Platform](https://omnira.so). Manage your leads, offerings, sales pipeline, and AI-driven outreach from your terminal — built for both human use and AI agent integration (Claude Code, OpenClaw).

## Install

```bash
uv tool install omnira
```

Or with pipx:

```bash
pipx install omnira
```

Then authenticate with your Omnira API key (find it under **Settings → API** in the Omnira dashboard):

```bash
omnira login
```

## Quick Start

```bash
omnira account                     # confirm authentication, see credits
omnira leads list                  # see your leads
omnira offerings list              # see your products/services
omnira pipeline summary            # pipeline overview
omnira hitl list                   # pending AI message approvals
```

Every command supports `--help` to discover its options:

```bash
omnira leads --help
omnira leads list --help
```

## Use With AI Agents

The CLI is designed to be operated by AI agents like Claude Code. To set up an agent integration:

```bash
omnira agent install
```

This installs a skill file and instructions into your project (or globally), so Claude Code can discover and use the CLI without manual configuration.

After running `omnira agent install`, restart Claude Code in your project and ask:

> "List my pending HITL messages and tell me which to approve"

## What You Can Do

- **Leads** — list, create, fetch new leads, enrich with GTM data, mark won/lost
- **Offerings** — manage products/services, generate sales processes, configure templates
- **Outreach** — launch campaigns, pause/resume, force steps, view conversations
- **Pipeline** — create stages, move leads, view summary
- **HITL** — review, approve, edit, or reject AI-generated messages
- **Messages** — send SMS, email, and iMessage manually
- **Action Plans** — review and approve AI-suggested next actions
- **Calendar** — manage appointments and availability
- **Aria** — chat with your AI business advisor

Run `omnira --help` to see all command groups.

## Output Formats

By default, output is formatted as a rich table when running interactively, or as JSON when piped:

```bash
omnira leads list                  # table view
omnira leads list -o json          # explicit JSON
omnira leads list | jq '.data.leads[].email'   # auto-detects pipe → JSON
```

## Configuration

Configuration is stored in `~/.omnira/config.toml`. You can manage multiple profiles:

```bash
omnira --profile staging login
omnira --profile staging leads list
```

Environment variables override config file values:

- `OMNIRA_API_KEY` — your API key
- `OMNIRA_API_URL` — gateway URL (defaults to `https://api.omnira.so`)
- `OMNIRA_PROFILE` — active profile name
- `OMNIRA_OUTPUT` — output format (`auto`, `json`, `table`, `plain`)

## Support

- Documentation: [docs.omnira.so/cli](https://docs.omnira.so/cli)
- Dashboard: [app.omnira.so](https://app.omnira.so)
- Issues: support@omnirasystems.com

## License

Proprietary. © Omnira.
