Metadata-Version: 2.4
Name: live-cmd
Version: 0.1.0
Summary: Live stream command line output.
Project-URL: Homepage, https://github.com/astralarium/live
Author: Mara Kim
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# live

Live stream command line output.

See [DESIGN.md](DESIGN.md) for the design spec and [DEVELOPMENT.md](DEVELOPMENT.md) for working on `live` itself.

## Install

```sh
pipx install live-cmd
# or
uv tool install live-cmd
```

## Usage

```sh
live run -n dev npm run dev   # record under PTY, mirror to terminal
live ls                       # list sessions started under cwd
live ls -g                    # list all sessions
live tail -vn +0 dev          # resumable polling for agents
live cat dev                  # full output
live rm dev                   # delete
```

Sessions are stored under `~/.live/sessions/`; `live ls`/`cat`/`head`/`tail`/`rm` filter to sessions started in the current directory. Pass `-g` / `--global` to search globally.

## Shell completion

```sh
live update-shell        # detect $SHELL, install completion, reload your shell
```

Or print the script and place it yourself:

```sh
live completion bash > ~/.local/share/bash-completion/completions/live
live completion zsh  > "${fpath[1]}/_live"
live completion fish > ~/.config/fish/completions/live.fish
```
