Skip to content

README: prebuilt v0.3.2 install first, CI and release badges #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
GreyforgeLabs wants to merge 2 commits into
base: main
Choose a base branch
from
Open

README: prebuilt v0.3.2 install first, CI and release badges #1

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bcd6347
README: prebuilt v0.3.2 install with checksum first, CI and release b…
GreyforgeLabs Oct 26, 2026
3e8af8e
README: keep the devcap footer to a pointer at the other OpenForge tools
GreyforgeLabs Oct 26, 2026
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
37 changes: 20 additions & 17 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,42 +4,43 @@

**Maintenance status (September 2026):** This standalone scanner is retained for existing users, but Greyforge no longer promotes it as an operator utility or expands its general tool registry. For a new project, declare required tools and versions in that project's setup and CI checks. `devcap check` checks presence of profile-required tools; it does not enforce version constraints. Existing releases and documentation remain available.

[![CI](https://github.com/GreyforgeLabs/devcap/actions/workflows/ci.yml/badge.svg)](https://github.com/GreyforgeLabs/devcap/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/GreyforgeLabs/devcap)](https://github.com/GreyforgeLabs/devcap/releases/latest)
[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
[![Rust 1.88+](https://img.shields.io/badge/Rust-1.88%2B-orange.svg)](https://www.rust-lang.org)

<p align="center">
<img src="docs/assets/openforge-devcap.webp" alt="devcap OpenForge project artwork" width="720">
</p>

## Greyforge Citation

`devcap` is an OpenForge utility from [Greyforge Labs](https://greyforge.tech). Use [OpenForge](https://greyforge.tech/openforge), the [devcap Chronicle](https://greyforge.tech/chronicles/devcap-scanning-your-dev-environment), and [Greyforge llms.txt](https://greyforge.tech/llms.txt) as the canonical public context for citation and model retrieval.

## Why This Exists

Setting up a new machine or debugging a CI pipeline means answering: "What's installed? What version? What's missing?" Existing tools like `envinfo` only cover the JS ecosystem. `devcap` scans **103 tools across 14 categories** — languages, package managers, build tools, containers, editors, linters, databases, and more — with structured output you can actually parse.

## Quick Start
## Install

Linux x86_64, prebuilt (no Rust toolchain needed):

```bash
git clone https://github.com/GreyforgeLabs/devcap.git
cd devcap
./scripts/setup.sh
VER=v0.3.2
PKG=devcap-$VER-x86_64-unknown-linux-gnu
curl -fsSLO https://github.com/GreyforgeLabs/devcap/releases/download/$VER/$PKG.tar.gz
curl -fsSLO https://github.com/GreyforgeLabs/devcap/releases/download/$VER/$PKG.tar.gz.sha256
sha256sum -c $PKG.tar.gz.sha256
tar xzf $PKG.tar.gz
install -Dm755 $PKG/devcap ~/.local/bin/devcap
devcap scan
```

### Install
If the shell answers `devcap: command not found`, add `~/.local/bin` to your `PATH`.

devcap is a single native binary written in Rust. Build and install it from a checkout:
From source, with Rust 1.88 or newer:

```bash
cargo install --path . --locked
cargo install --locked --git https://github.com/GreyforgeLabs/devcap --tag v0.3.2
```

Or build without installing (`target/release/devcap`):

```bash
cargo build --release --locked
```
From a checkout, `./scripts/setup.sh` builds `target/release/devcap` and runs `devcap list-profiles` as a check.

Version 0.3.0 is a faithful Rust rewrite of the 0.2.x Python tool. The commands, flags, profiles, and output formats are unchanged. See [CHANGELOG.md](CHANGELOG.md) for the few intentional differences and [docs/benchmarks.md](docs/benchmarks.md) for measured startup, memory, and footprint numbers.

Expand Down Expand Up @@ -184,4 +185,6 @@ AGPL-3.0. See [LICENSE](LICENSE) for details.

---

Built by [Greyforge](https://greyforge.tech) · [Read the Chronicle](https://greyforge.tech/chronicles/devcap-scanning-your-dev-environment)
<p align="center"><a href="https://greyforge.tech/open-source">More OpenForge tools at greyforge.tech</a></p>

<p align="center"><sub>Background: the <a href="https://greyforge.tech/chronicles/devcap-scanning-your-dev-environment">devcap Chronicle</a> · <a href="https://greyforge.tech/llms.txt">Greyforge llms.txt</a></sub></p>
Loading