live
Live stream command line output.
Enable agents to inspect logs via familiar interfaces like cat and tail.
Explore logs from long-running or long-dead processes.
Large logs auto-rotate. Old sessions are cleaned opportunistically.
No long running daemons. All state is stored in ~/.live.
Requires Python 3.10+. Zero dependencies.
Install
pipx install live-cmd
# or
uv tool install live-cmd
Install shell completions:
live update-shell
Install agent skill:
npx skills add astralarium/live
Print agent guide:
live llms.txt
Usage
Record command:
live run -n server npm start # foreground
live run -dn server npm start # run detached; print session UUID
Inspect sessions:
live ps # active sessions
live ps -ag # all sessions
live less server # interactive paging
live tail -f server # follow logs
Select by name (newest match) or UUID prefix.
Commands are scoped to the current directory (and descendants); pass -C PATH to scope another directory, or -g for global scope.
Stop and clean up:
live stop server
live rm server
live rm --exited --older-than 1d
Agents
Resumable streaming for agents using POSIX semantics:
live cat -v server
Verbose output (-v) returns stream metadata on stderr.
live: id=925f… next-line=42 next-byte=250 last-time=1800…
Continue reading from next line:
live tail -vn +42 server
Config
~/.live/config.json, auto-created.
| Option | Default | Description |
|---|---|---|
ttlDays |
7 |
Time before old sessions are cleaned up. Negative value to disable. |
maxKb |
512 |
Per-session output cap, in KB. Older segments are dropped. |
segmentKb |
64 |
Segment file size, in KB, before rotation. |
heartbeatSec |
30 |
Seconds between writer heartbeats; 3× this marks a session hung. |
References
Links
1 maintainer
Metadata
1 maintainer
Release files for live-cmd 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| live_cmd-0.6.0.tar.gz | 137.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| live_cmd-0.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 216.0 kB
Release files / live_cmd-0.6.0.tar.gz
| Download URL | live_cmd-0.6.0.tar.gz |
|---|---|
| Size | 137.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3804904a74e126daedfc17e28205e9216234234241b495b1cde4dccbb6c41476
|
|
BLAKE2b-256 checksum How to use checksums |
203b2fd3cbe890ad772cf280779e40c461ed1ee4b31bd7104b838644663edd61
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.3
|
Release files / live_cmd-0.6.0-py3-none-any.whl
| Download URL | live_cmd-0.6.0-py3-none-any.whl |
|---|---|
| Size | 78.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
580f414acb70de7b4c9aa8c2b4009f23787d983d4fc6d9463a704a797af5114c
|
|
BLAKE2b-256 checksum How to use checksums |
e5d871c71db41e7cc105f32d9ce73f79401b1cb72759ebf4168af11318b4b91f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.3
|
