{"id":51478125,"url":"https://github.com/oxyzenq/zejtron","last_synced_at":"2026-07-06T23:01:16.859Z","repository":{"id":360283425,"uuid":"1249453272","full_name":"oxyzenQ/zejtron","owner":"oxyzenQ","description":"Unified Linux introspection toolkit for paths, ports, processes, files, services, and diagnostics","archived":false,"fork":false,"pushed_at":"2026-07-01T12:00:06.000Z","size":4199,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-01T13:24:33.578Z","etag":null,"topics":["cli","command-line","developer-tools","environment","linux","path","ports","rust","system-tool","terminal"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oxyzenQ.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"rezky"}},"created_at":"2026-05-25T18:05:01.000Z","updated_at":"2026-07-01T11:59:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oxyzenQ/zejtron","commit_stats":null,"previous_names":["oxyzenq/nestkit","oxyzenq/zejtron"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/oxyzenQ/zejtron","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxyzenQ%2Fzejtron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxyzenQ%2Fzejtron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxyzenQ%2Fzejtron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxyzenQ%2Fzejtron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oxyzenQ","download_url":"https://codeload.github.com/oxyzenQ/zejtron/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oxyzenQ%2Fzejtron/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35208141,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","developer-tools","environment","linux","path","ports","rust","system-tool","terminal"],"created_at":"2026-07-06T23:01:15.769Z","updated_at":"2026-07-06T23:01:16.843Z","avatar_url":"https://github.com/oxyzenQ.png","language":"Rust","funding_links":["https://ko-fi.com/rezky"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/zejtron-logo-new.png\" alt=\"zejtron logo\" width=\"260\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003ezejtron\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eA serious Linux introspection command center for operators, engineers, and incident work.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Trace commands, ports, process trees, file holders, service evidence, and host readiness from one disciplined terminal interface.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://ko-fi.com/rezky\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Ko--fi-support-7C3AED?style=flat-square\u0026logo=kofi\u0026logoColor=white\u0026labelColor=111827\" alt=\"Support on Ko-fi\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## What Is Zejtron?\n\nZejtron is a Linux-first command center for terminal introspection.\nIt consolidates functionality from pidnest and Zenlixem into one binary with one release flow.\n\n| Origin | Zejtron command |\n| --- | --- |\n| pidnest | `zejtron proc` |\n| Zenlixem `whoholds` | `zejtron holds` |\n| Zenlixem `lasttouch` | `zejtron touch` |\n| Zenlixem `whyopen` | `zejtron why` |\n| Zenlixem `doctor` | `zejtron net` |\n| Zenlixem `envpath` | covered by `zejtron path` |\n\n## Install\n\n### AUR\n\n```sh\nparu -S zejtron-bin\nyay -S zejtron-bin\n```\n\n### GitHub Release\n\n```sh\nTAG=v10.0.2\ncurl -LO \"https://github.com/oxyzenQ/zejtron/releases/download/${TAG}/zejtron-${TAG}-linux-amd64-gnu.tar.gz\"\ncurl -LO \"https://github.com/oxyzenQ/zejtron/releases/download/${TAG}/zejtron-${TAG}-linux-amd64-gnu.tar.gz.sha512sum\"\nsha512sum --check \"zejtron-${TAG}-linux-amd64-gnu.tar.gz.sha512sum\"\ntar -xzf \"zejtron-${TAG}-linux-amd64-gnu.tar.gz\"\ninstall -Dm755 zejtron \"$HOME/.local/bin/zejtron\"\n```\n\nFor a statically-linked musl build, replace `linux-amd64-gnu` with `linux-amd64-musl`.\n\nEach release also ships quantum-resistant checksums (BLAKE2b + SHAKE256).\nSee [docs/VERIFY_RELEASE.md](docs/VERIFY_RELEASE.md) for full instructions.\n\n### From Source\n\n```sh\ngit clone https://github.com/oxyzenQ/zejtron\ncd zejtron\ncargo install --path .\n```\n\n## Command Overview\n\n| Command | Purpose |\n| --- | --- |\n| `path` | Trace command origin |\n| `recent` | Show recently modified files |\n| `port` | Inspect ports and process owners |\n| `proc` | Inspect process trees by user or UID |\n| `holds` | Show processes holding a file, device, or port |\n| `touch` | Inspect last modification evidence for a path |\n| `why` | Explain visible evidence for a path or port |\n| `env` | Snapshot and diff environment variables |\n| `service` | Inspect systemd services |\n| `shell` | Inspect current shell context |\n| `net`   | Inspect network interfaces and routing |\n| `git`   | Inspect git repository context |\n| `doctor` | Check Zejtron system capability/readiness |\n\n## Quick Examples\n\n```sh\nzejtron path sh\nzejtron port --tcp --group\nzejtron proc --me --depth 1\nzejtron holds 53\nsudo zejtron holds 53\nzejtron touch /etc/resolv.conf\nzejtron why /etc/resolv.conf\nzejtron doctor\nzejtron -V\nzejtron --check-update\n```\n\n`-V` and `--version` print complete version, build, license, and source\nmetadata. `--check-update` checks the latest upstream GitHub release; the\n`--check-updated` alias is accepted too.\n\n## Compatibility\n\nZejtron is Linux-first and expects procfs at `/proc`. Most commands work without systemd: `path`, `recent`, `port`, `env`, `proc`, `holds`, `touch`, `why`, and `doctor`.\n\n`service` requires systemd and `systemctl`. `touch` and `why` can use filesystem metadata on supported Linux systems, while journal evidence depends on `journalctl` and systemd journal availability. `holds`, `port`, and `proc` may show more complete details with `sudo` on hardened systems. `net` reads from sysfs and procfs without external commands. `git` requires the `git` binary and only invokes read-only subcommands.\n\n## Safety\n\nZejtron is read-only by design. It does not kill processes, close ports, start or stop services, or modify files. `zejtron touch` inspects file evidence; it is not shell `touch` and does not create files or change timestamps.\n\n## Commands\n\n### `path`\n\nTrace where a command comes from by scanning `PATH`, showing all matches, the active match, executable status, symlink targets, and Arch package ownership when `pacman` is available.\n\n```sh\nzejtron path sh\n```\n\n### `recent`\n\nShow recently modified files under a path.\n\n```sh\nzejtron recent\nzejtron recent . --limit 5\nzejtron recent ~/src --since 1d\n```\n\n### `port`\n\nShow listening TCP/UDP ports and process owners when discoverable.\n\n```sh\nzejtron port\nzejtron port 3000\nzejtron port --tcp --group\nzejtron port --udp\nzejtron port --all\nzejtron port --no-pid\n```\n\n### `proc`\n\nShow a clean process tree for a Linux user or UID.\n\n```sh\nzejtron proc --me\nzejtron proc rezky\nzejtron proc root --depth 1\nzejtron proc rezky --find python\nzejtron proc rezky --no-pid\nzejtron proc rezky --live --interval 6\n```\n\n### `holds`\n\nShow processes holding a file, device, or specific TCP/UDP port.\n\n```sh\nzejtron holds 3000\nzejtron holds /etc/resolv.conf\nzejtron holds /dev/nvme0n1\n```\n\n### `touch`\n\nInspect last modification evidence for a path. Metadata shows when a path changed, not who changed it; audit and journal evidence is best-effort.\n\n```sh\nzejtron touch /etc/resolv.conf\nzejtron touch ./README.md\nzejtron touch \"/path/with spaces/file.txt\"\n```\n\n### `why`\n\nExplain visible evidence for a path or port without inferring intent.\n\n```sh\nzejtron why 53\nzejtron why 3000\nzejtron why /etc/resolv.conf\nzejtron why ./README.md\n```\n\n### `env`\n\nInspect current environment variables, save named snapshots, and diff a saved snapshot against the current terminal environment.\n\n```sh\nzejtron env\nzejtron env --keys\nzejtron env --filter path\nzejtron env save base\nzejtron env diff base\nzejtron env list\nzejtron env delete base\n```\n\n### `service`\n\nInspect systemd service units in a read-only view.\n\n```sh\nzejtron service\nzejtron service --user\nzejtron service --failed\nzejtron service --all\nzejtron service --filter unbound\n```\n\n### `doctor`\n\nCheck Linux/procfs visibility, visible processes, `/proc/net` socket parsing, holder scan readiness, optional audit and journal evidence, systemctl/systemd availability, and build metadata.\n\n```sh\nzejtron doctor\n```\n\n### `shell`\n\nInspect current shell context in a read-only view. Reports the parent process, login shell, terminal, shell-related environment variables, and known config file paths for the detected shell.\n\n```sh\nzejtron shell\n```\n\n### `net`\n\nInspect network interfaces and routing context in a read-only view. Reports interfaces from sysfs with state, MTU, and MAC address. Shows default route from procfs and resolver file status.\n\n```sh\nzejtron net\n```\n\n### `git`\n\nInspect git repository context in a read-only view. Reports the repository root, branch, working tree status, latest commit, and remote URLs. Only invokes read-only git subcommands. Credentials embedded in remote URLs (e.g. PATs in HTTPS URLs) are redacted as `\u003credacted\u003e` in output.\n\n```sh\nzejtron git\n```\n\n## Roadmap\n\nSee [docs/ROADMAP.md](docs/ROADMAP.md) for the project roadmap and design direction, or [docs/ROADMAP-current.md](docs/ROADMAP-current.md) for the current design document.\n\n## Migration\n\n`pidnest` and Zenlixem are superseded by Zejtron. See the origin table above for command mapping.\n\n## Development\n\n```sh\n./scripts/build.sh\nSKIP_CODESPELL=1 ./scripts/build.sh\n./scripts/version-to.sh vX.Y.Z\n```\n\n## Intellectual Property \u0026 Trademark\n\n**zejtron** is the exclusive intellectual property of\n**rezky_nightky (oxyzenQ)**.\n\n- Source code: licensed under **GPL-3.0-only** (see [LICENSE](LICENSE)).\n- Name, logo, and branding (\"the Marks\"): governed by\n  [TRADEMARK.md](TRADEMARK.md). The Marks are NOT covered by the GPL and\n  are reserved by the owner.\n- This project is **NOT for sale**. Unauthorized rebranding, relicensing,\n  or source-code theft is strictly prohibited.\n\nFor trademark licensing or written permission, contact\n**rezky_nightky (oxyzenQ)** — https://github.com/oxyzenQ.\n\n---\n\n© 2026 rezky_nightky (oxyzenQ). All rights reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxyzenq%2Fzejtron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foxyzenq%2Fzejtron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foxyzenq%2Fzejtron/lists"}