An open API service indexing awesome lists of open source software.

https://github.com/lucasnevespereira/logmx

Aggregate and stream logs from multiple platforms into a single terminal view
https://github.com/lucasnevespereira/logmx

cli devtools go golang log-aggregator logs railway terminal vercel

Last synced: 3 months ago
JSON representation

Aggregate and stream logs from multiple platforms into a single terminal view

Awesome Lists containing this project

README

          

# logmx

[![CI](https://img.shields.io/github/actions/workflow/status/lucasnevespereira/logmx/ci.yml?style=flat-square)](https://github.com/lucasnevespereira/logmx/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/lucasnevespereira/logmx?style=flat-square)](https://github.com/lucasnevespereira/logmx/releases/latest)

Aggregate and stream logs from multiple platforms into a single terminal view.

```
21:04:12 vercel INFO request completed in 42ms
21:04:12 railway INFO database connected
21:04:13 vercel ERROR connection timeout after 30s
21:04:13 railway WARN memory usage at 80%
```

## Install

```sh
brew install lucasnevespereira/tools/logmx
```

Or with Go:

```sh
go install github.com/lucasnevespereira/logmx/cmd/logmx@latest
```

## Quick Start

```sh
logmx setup # pick providers, authenticate, select projects
logmx tail -f # stream logs in real time
```

## Usage

```sh
# Setup
logmx setup # Interactive setup wizard

# View logs
logmx tail # Show recent logs and exit
logmx tail -f # Stream logs in real time
logmx tail -n 50 # Show last 50 logs per source
logmx tail -s my-api # Filter by source
logmx tail --level error # Filter by log level
logmx tail -f -s my-api # Stream a specific source

# Manage providers & sources
logmx auth vercel # Add or refresh a provider token
logmx auth railway # Log in to Railway CLI
logmx source add # Add sources (pick provider)
logmx source add --from vercel # Add sources from a specific provider
logmx source list # List configured sources
logmx source remove my-docs # Remove a source
```

`tail` works like unix `tail` — shows recent logs and exits. Add `-f` to follow in real time, just like `tail -f`.

## Supported Providers

| Provider | Auth | Streaming via |
| -------- | --------------- | ---------------- |
| Vercel | API token | `vercel` CLI |
| Railway | `railway login` | `railway` CLI |
| Fly.io | Planned | — |
| Render | Planned | — |

## Documentation

- [Architecture](docs/ARCHITECTURE.md) — how it works internally
- [Roadmap](docs/ROADMAP.md) — what's planned

## Contributing

Contributions welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) to get started.

## License

[MIT](LICENSE)