Metadata-Version: 2.4
Name: notamify
Version: 0.4.0
Summary: Notamify command line: NOTAMs, airport and flight briefings, and NOTAM Watcher, for people and AI agents
Author: Damian Szumski
License-Expression: MIT
Project-URL: Homepage, https://github.com/skymerse/notamify-sdk-python
Project-URL: Repository, https://github.com/skymerse/notamify-sdk-python
Project-URL: Issues, https://github.com/skymerse/notamify-sdk-python/issues
Keywords: notam,aviation,cli,briefing,agents
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: notamify-sdk==0.4.0

# notamify

**OpenClaw and agents ready.**

The Notamify command line: NOTAMs, affected infrastructure, airport and flight briefings, and NOTAM Watcher webhooks. It is built for people at a terminal and for AI agents (Claude Code, Codex, OpenClaw and others) alike.

## Install

```bash
uv tool install notamify      # or: pipx install notamify
notamify --version
```

Both tools install the `notamify` command into `~/.local/bin`. If your shell says `command not found: notamify`, that directory is not on your `PATH` yet:

```bash
uv tool update-shell          # or: pipx ensurepath
```

Then open a new terminal. To check without changing anything, run `~/.local/bin/notamify --version`, or run it without installing: `uvx notamify --version`.

With plain pip, install into a virtual environment (`pip install notamify`); the command is then in that environment's `bin/` directory and is on `PATH` while the environment is active.

To update: `uv tool upgrade notamify` (or `pipx upgrade notamify`).

## Sign in

Two ways, and you can use both:

```bash
notamify auth login              # sign in with your Notamify account in the browser
notamify auth login --api-key    # or save an API key (~/.config/notamify/config.json, mode 0600)
notamify auth status             # which one each command uses
```

- **Notamify account.** Like the Notamify plugins for Claude, Codex and ChatGPT: the browser opens notamify.com, you approve the CLI, and requests are billed to your account at the connected-app rate. No key to copy. Needs Notamify Pro. Covers NOTAMs and briefings. Manage or revoke the connection at [notamify.com/account](https://notamify.com/account#connections). On a remote machine, use `notamify auth login --no-browser --port 8765` and forward the port: `ssh -L 8765:127.0.0.1:8765 host`.
- **API key.** Create one at [notamify.com/api-manager](https://notamify.com/api-manager). Needed for Watcher commands and `notams raw`. `NOTAMIFY_TOKEN` takes precedence over everything else, which suits CI, containers and agents.

`--auth account` or `--auth api-key` (or `NOTAMIFY_AUTH`) picks one explicitly.

## Use

```bash
notamify notams active EPWA EGLL --start now --hours 24
notamify affected EPWA --affected CLOSED:RUNWAY
notamify notams get NOTAM_ID
notamify briefing airport EPWA
notamify briefing flight create --origin EPWA@now/+2h --destination EGLL@+2h/+3h --aircraft B738 --wait
notamify watcher listeners list
notamify webhook listen --tunnel
notamify commands             # every command, its credit cost and the exit codes
```

On a terminal you get readable text. When the output is piped, as it is for agents, you get JSON; force either with `--json` or `--output text`.

Commands that may spend more than one credit (`--all`, briefings, prioritize) or change Watcher listeners ask for confirmation. Without a terminal they exit with code 4 and print the exact command to rerun with `--yes`. `--dry-run` shows the request and its estimated cost without sending it.

## For AI agents

```bash
notamify skill install                       # ~/.claude/skills/notamify/SKILL.md
notamify skill install --dir ~/.codex/skills # or any other skills directory
```

The skill tells an agent which command to use, how to read pagination and exit codes, and how to ask before spending credits. Chat apps without a shell (ChatGPT, Claude web and desktop) should use the hosted Notamify MCP server at `https://mcp.notamify.com/mcp` instead.

NOTAM interpretations and briefings are informational. Verify official aviation sources before making operational decisions.

The CLI is part of [notamify-sdk](https://github.com/skymerse/notamify-sdk-python); `python -m notamify_sdk.cli` runs the same command from the SDK alone.
