meta

CI PyPI version Python 3.13+ License: MIT

meta is a minimal-dependency (runtime uses only typer), offline-first CLI that drops into any codebase and instantly surfaces what it is, how it's structured, and what you need to know. No magic, no internet required, no configuration needed.

✨ Features

  • Instant Detection: Project type, framework, and language from marker files — no configuration needed
  • Dependency Visibility: Production and dev dependencies across Node.js, Python, Rust, Go, Ruby, and PHP
  • Script Discovery: Runnable scripts from package.json, Makefile, justfile, Taskfile.yml, and pyproject.toml
  • Environment Awareness: Expected vs. set environment variables, with source usage locations
  • Health Checks: Missing lockfiles, stale READMEs, leaked secrets, missing CI config
  • Multi-Platform: PyPI, Homebrew, and pre-built binary distribution

📦 Installation

Homebrew

brew tap alkalescent/tap && brew install meta

PyPI

uv pip install meta.one

From Source

git clone https://github.com/alkalescent/meta.git
cd meta
make install DEV=1

Pre-built Binaries

Download from GitHub Releases for portable or fast execution options.

🚀 Quick Start

meta

(Example output surfaces project details like structure and dependencies)

🛠️ Commands

  • deps: List dependencies. meta deps
  • scripts: List defined scripts. meta scripts
  • env: List environment variables. meta env
  • size: Show project size and line counts. meta size
  • contributors: List top contributors. meta contributors
  • health: Check project health and metrics. meta health

⚙️ Global Flags

Flag Description
--json Output results in JSON format
--no-color Disable colored output
--quiet Suppress non-essential output
--path Specify project path
--version Show version
--help Show help message

🧪 Testing

Run tests locally:

make test
make cov
make smoke

🏗️ Architecture

  • detect.py: Project detection logic
  • deps.py: Dependency parsing
  • pep440.py: Version parsing and specifier matching
  • scripts.py: Script extraction
  • env.py: Environment variable scanning
  • size.py: Size calculation
  • contributors.py: Git contributor analysis
  • health.py: Health checks
  • output.py: Output formatting
  • walk.py: Shared traversal settings
  • cli.py: Command-line interface

📄 License

MIT

Project links

Data verified by PyPI on Aug 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for alkalescent from gravatar.com alkalescent

Credits

Author: Krish Suchak

GitHub Statistics

Data verified by PyPI on Aug 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.13

Tags

analysis cli codebase developer-tools intelligence project

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meta_one-1.7.0.tar.gz (222.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meta_one-1.7.0-py3-none-any.whl (30.3 kB view details)

Uploaded Python 3

File details

Details for the file meta_one-1.7.0.tar.gz.

File metadata

  • Download URL: meta_one-1.7.0.tar.gz
  • Upload date:
  • Size: 222.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for meta_one-1.7.0.tar.gz
Algorithm Hash digest
SHA256 b39d24da55bcec23c4281169ba2b60184b10801abf689694857c6a52e4067fa2
MD5 c65e3b56dcc2d399a404eb601879f9df
BLAKE2b-256 39c6b0568735446fa45c92efa051ec0794cfaa6d51425a5c156a39de73e4a9f7

See more details on using hashes here.

Provenance

The following attestation bundles were made for meta_one-1.7.0.tar.gz:

Publisher: release.yml on alkalescent/meta

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file meta_one-1.7.0-py3-none-any.whl.

File metadata

  • Download URL: meta_one-1.7.0-py3-none-any.whl
  • Upload date:
  • Size: 30.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for meta_one-1.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b6a7e702678004d61468d9599f977e89c892ecd488f117ed941af65904857d97
MD5 fde784d12d058f1bae9bc66517f4cb65
BLAKE2b-256 7fabb7ce45e3785d1fa973ce1f36198f466fe809a7c2a44ca0a10ccc8c5b4756

See more details on using hashes here.

Provenance

The following attestation bundles were made for meta_one-1.7.0-py3-none-any.whl:

Publisher: release.yml on alkalescent/meta

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.7.0 This release

2 files

1.6.0

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page