Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 21 additions & 41 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,17 @@
# envui

![Static Badge](https://img.shields.io/badge/node.js-%E2%89%A518-brightgreen)

Copilot AI Sep 2, 2025

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The HTML entity '%E2%89%A5' for the ≥ symbol in the badge URL should be URL-encoded as '%E2%89%A5' or use the literal character '≥'. However, the current encoding appears correct - this may render properly as intended.

Suggested change
![Static Badge](https://img.shields.io/badge/node.js-%E2%89%A518-brightgreen)
![Static Badge](https://img.shields.io/badge/node.js-≥18-brightgreen)

Copilot uses AI. Check for mistakes.

Beautiful environment variable viewer - A modern alternative to `printenv`

## About

envui is a CLI tool that displays environment variables in a clean, readable table format with color highlighting. It's designed to be a more user-friendly alternative to the traditional `printenv` command.

## Requirements

- Node.js ≥ 18

## Installation

```bash
Expand All @@ -17,64 +23,38 @@ npm install -g @flowernotfound/envui
```bash
# Display all environment variables
envui
```

```bash
# Prefix filtering (case-insensitive)
envui VITE_
envui NODE_
```

Demo output:

![Demo prefix filtering](./assets/demo_prefix.png)

Copilot AI Sep 2, 2025

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The demo images reference local asset files that may not exist in the repository. Consider verifying these image files are included in the PR or use alternative hosting for the demo images.

Copilot uses AI. Check for mistakes.

```bash
# Filter by partial match (case-insensitive)
envui --filter API
envui -f API
envui --filter database
envui -f database
```

Demo output:

![Demo filter functionality](./assets/demo_filter.png)

Copilot AI Sep 2, 2025

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The demo images reference local asset files that may not exist in the repository. Consider verifying these image files are included in the PR or use alternative hosting for the demo images.

Copilot uses AI. Check for mistakes.

```bash
# Display help
envui --help

# Show version
envui --version
```

## Development

```bash
# Install dependencies
pnpm install

# Build the project
pnpm build

# Run in development mode
pnpm dev

# Run tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Run tests with coverage
pnpm test:coverage

# Type checking
pnpm typecheck

# Lint code
pnpm lint

# Fix lint issues automatically
pnpm lint:fix

# Format code
pnpm format

# Check code formatting
pnpm format:check

# Clean build artifacts
pnpm clean
```

## License

MIT
[MIT license](https://github.com/flowernotfound/envui/blob/master/LICENSE)
Binary file added assets/demo_filter.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/demo_prefix.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.