From 83d2777de4219dad59a0ece9697a1b155ed3440e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Mon, 27 Apr 2026 09:52:21 +0000 Subject: [PATCH 1/2] =?UTF-8?q?[discover]=203=20candidates=20for=20review?= =?UTF-8?q?=20=E2=80=94=202026-04-27?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .discover/candidates.json | 46 ++++++++++++++++++++++++++++++++++----- .discover/triage.json | 2 +- 2 files changed, 41 insertions(+), 7 deletions(-) diff --git a/.discover/candidates.json b/.discover/candidates.json index 33d1719..7313aee 100644 --- a/.discover/candidates.json +++ b/.discover/candidates.json @@ -1,19 +1,53 @@ [ { - "repo": "guillaumemaka/just-bash-mcp", + "repo": "MauricioPerera/just-bash-data", "checks": { "readme_is_about_project": true, "install_command_matches_name": true, "has_usage_example": true, "describes_unique_value": true, - "is_not_copy_of_just_bash": true, + "is_not_copy_of_canonical": true, "has_real_code": true, - "is_just_bash_focused": true + "is_subject_focused": true }, "relevant": true, - "confidence": 0.8, + "confidence": 0.92, + "category": "Libraries", + "description": "Plugin adding `db` (MongoDB-style document store) and `vec` (vector similarity search) commands to just-bash, with JWT auth, RBAC, and AES-256-GCM encryption", + "reasoning": "All checks pass: has_package_dep and readme_imports_package are both true, the README is detailed and original, and it's clearly a just-bash-focused library adding structured-data commands via custom commands API." + }, + { + "repo": "nathan-gage/pydantic-ai-just-bash", + "checks": { + "readme_is_about_project": true, + "install_command_matches_name": true, + "has_usage_example": true, + "describes_unique_value": true, + "is_not_copy_of_canonical": true, + "has_real_code": true, + "is_subject_focused": true + }, + "relevant": true, + "confidence": 0.88, "category": "Integrations", - "description": "Second MCP server wrapping just-bash with Laminar observability tracing, configurable timeouts, and VS Code MCP integration support", - "reasoning": "Clearly a just-bash MCP integration with real implementation details, install instructions, usage examples, and additional features (Laminar tracing, packaging). Similar to the existing just-bash-mcp entry but by a different author with distinct features." + "description": "PydanticAI toolset wrapping just-py-bash as a persistent shell capability, exposing wrapped tools as bash commands with deferred loading and long-lived virtual filesystem", + "reasoning": "All checks pass: install command references `pydantic-ai-just-bash`, README has rich usage examples, it's clearly just-bash-focused (via just-py-bash), and the PyPI badge confirms real published code." + }, + { + "repo": "sumedhkhodke/postgres-vfs", + "checks": { + "readme_is_about_project": true, + "install_command_matches_name": true, + "has_usage_example": true, + "describes_unique_value": true, + "is_not_copy_of_canonical": true, + "has_real_code": true, + "is_subject_focused": true + }, + "relevant": true, + "confidence": 0.93, + "category": "Filesystem Adapters", + "description": "PostgreSQL-backed `IFileSystem` with per-tenant row isolation, full-text search, optional pgvector semantic search, and a built-in Web UI — 70+ Unix commands backed by SQL", + "reasoning": "All checks pass: has_package_dep is true, README clearly describes a just-bash IFileSystem adapter with rich original documentation, has a homepage, stars, and CI badge confirming real published code." } ] diff --git a/.discover/triage.json b/.discover/triage.json index 02606ac..a340092 100644 --- a/.discover/triage.json +++ b/.discover/triage.json @@ -1 +1 @@ -{"entries":[{"repo":"constructive-io/just-bash-test","checks":{"readme_is_about_project":false,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":false,"is_not_copy_of_just_bash":true,"has_real_code":false,"is_just_bash_focused":false},"relevant":false,"confidence":0.97,"category":"Skip","description":"","reasoning":"This repo is about Postgres tooling (pgpm workspaces) and has nothing to do with vercel-labs/just-bash. The name 'just-bash-test' appears to be a coincidental collision. README describes Postgres/Docker setup, not any just-bash integration."},{"repo":"dbreunig/dspy-just-bash-interpreter","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_just_bash":true,"has_real_code":false,"is_just_bash_focused":true},"relevant":false,"confidence":0.8,"category":"Skip","description":"","reasoning":"While conceptually interesting (DSPy RLM integration using just-bash-py), the README is extremely sparse with no install command, no usage example, and explicitly marked as proof-of-concept. Insufficient evidence of real code or usable implementation to justify inclusion."},{"repo":"guillaumemaka/just-bash-mcp","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_just_bash":true,"has_real_code":true,"is_just_bash_focused":true},"relevant":true,"confidence":0.8,"category":"Integrations","description":"Second MCP server wrapping just-bash with Laminar observability tracing, configurable timeouts, and VS Code MCP integration support","reasoning":"Clearly a just-bash MCP integration with real implementation details, install instructions, usage examples, and additional features (Laminar tracing, packaging). Similar to the existing just-bash-mcp entry but by a different author with distinct features."},{"repo":"leif293/just-bash-lazy-sql","checks":{"readme_is_about_project":false,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":false,"is_not_copy_of_just_bash":false,"has_real_code":false,"is_just_bash_focused":false},"relevant":false,"confidence":0.97,"category":"Skip","description":"","reasoning":"The README is a near-verbatim copy of the canonical just-bash README (same security model, same installation instructions, same examples). Despite the Supabase SQL description, there's no unique content describing what this project actually adds. Fails the copy detection check."},{"repo":"mesopelagique/JustBash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_just_bash":true,"has_real_code":false,"is_just_bash_focused":true},"relevant":false,"confidence":0.75,"category":"Skip","description":"","reasoning":"A 4D-language port of just-bash which is an interesting concept, but the README has no install command, no usage examples, and the repo appears to be an empty stub (0 stars, created and pushed same day with no substantive content beyond a brief description). Insufficient evidence of real implementation."},{"repo":"mwolting/context-fs","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_just_bash":true,"has_real_code":true,"is_just_bash_focused":false},"relevant":false,"confidence":0.82,"category":"Skip","description":"","reasoning":"context-fs is a broader platform for exposing APIs as virtual filesystems; just-bash is one adapter among several (NFS, CLI, Linear, etc.). Fails the is_just_bash_focused check — just-bash is not central to its identity."},{"repo":"nicoalbanese/ai-sdk-memory-just-bash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_just_bash":true,"has_real_code":true,"is_just_bash_focused":false},"relevant":false,"confidence":0.78,"category":"Skip","description":"","reasoning":"This is a general AI SDK memory example that uses just-bash as one of three implementation approaches alongside structured-actions and observational patterns. Just-bash is not central to the project's identity — it's a supporting tool in a broader memory architecture demo."},{"repo":"Pibomeister/just-bash-vercel-ai-sdk-elements","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_just_bash":true,"has_real_code":true,"is_just_bash_focused":false},"relevant":false,"confidence":0.75,"category":"Skip","description":"","reasoning":"A broad production AI stack (RAG, memory, streaming UI, document ingestion) that uses just-bash as one component among many. Just-bash is not central to this project's identity — it fails the is_just_bash_focused check."},{"repo":"tobowers/minimal-just-bash-failure","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":false,"is_not_copy_of_just_bash":true,"has_real_code":true,"is_just_bash_focused":true},"relevant":false,"confidence":0.95,"category":"Skip","description":"","reasoning":"This is a bug reproduction repo demonstrating a just-bash failure, not a library, integration, or project building on just-bash. It has no value as an awesome-list entry."}]} +{"entries":[{"repo":"constructive-io/just-bash-test","checks":{"readme_is_about_project":false,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":false,"is_not_copy_of_canonical":true,"has_real_code":false,"is_subject_focused":false},"relevant":false,"confidence":0.97,"category":"Skip","description":"","reasoning":"This repo is about pgpm/modular Postgres tooling from Constructive — the name 'just-bash-test' is a coincidence/collision. No connection to vercel-labs/just-bash at all."},{"repo":"dbreunig/dspy-just-bash-interpreter","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.75,"category":"Integrations","description":"DSPy BashRLM wrapper using just-bash-py as a code interpreter for recursive language models","reasoning":"The README is minimal (proof-of-concept disclaimer, no install command, no code example), so it fails the install_command_matches_name and has_usage_example checks. It is genuinely related to just-bash (via just-bash-py) but lacks enough documentation to include."},{"repo":"devxiyang/just-bash-demo","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.72,"category":"Built With just-bash","description":"Incident-response agent demo: multi-source data, multi-file edits, test/lint loop, dual artifact generation in a just-bash sandbox","reasoning":"has_package_dep is true and the README is rich, but there is no install command referencing this project's own package name (it just says `npm install` with no package name). Fails install_command_matches_name check; it's a demo app rather than a reusable library so the check is somewhat less critical, but by strict rules it must be rejected."},{"repo":"leif293/just-bash-lazy-sql","checks":{"readme_is_about_project":false,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":false,"is_not_copy_of_canonical":false,"has_real_code":false,"is_subject_focused":false},"relevant":false,"confidence":0.97,"category":"Skip","description":"","reasoning":"The README is a near-verbatim copy of the canonical just-bash README — same security model, same installation instructions, same code examples. Fails is_not_copy_of_canonical and describes_unique_value."},{"repo":"MauricioPerera/just-bash-data","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.92,"category":"Libraries","description":"Plugin adding `db` (MongoDB-style document store) and `vec` (vector similarity search) commands to just-bash, with JWT auth, RBAC, and AES-256-GCM encryption","reasoning":"All checks pass: has_package_dep and readme_imports_package are both true, the README is detailed and original, and it's clearly a just-bash-focused library adding structured-data commands via custom commands API."},{"repo":"mesopelagique/JustBash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":false,"is_subject_focused":true},"relevant":false,"confidence":0.82,"category":"Ports","description":"","reasoning":"A 4D-language port of just-bash, but the README has no install command, no usage example, and no evidence of real code beyond the description. Too sparse to include."},{"repo":"mwolting/context-fs","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.82,"category":"Skip","description":"","reasoning":"context-fs is a broader virtual filesystem framework with just-bash as one of several adapters (`@context-fs/just-bash`) among NFS, CLI, and Linear adapters. Fails is_subject_focused — just-bash is not central to its identity."},{"repo":"nathan-gage/pydantic-ai-just-bash","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.88,"category":"Integrations","description":"PydanticAI toolset wrapping just-py-bash as a persistent shell capability, exposing wrapped tools as bash commands with deferred loading and long-lived virtual filesystem","reasoning":"All checks pass: install command references `pydantic-ai-just-bash`, README has rich usage examples, it's clearly just-bash-focused (via just-py-bash), and the PyPI badge confirms real published code."},{"repo":"nicoalbanese/ai-sdk-memory-just-bash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.78,"category":"Skip","description":"","reasoning":"This is a multi-approach persistent memory demo for AI SDK where just-bash is one of three implementations alongside structured-actions and observational approaches. Fails is_subject_focused — just-bash is not central to the project's identity."},{"repo":"Pibomeister/just-bash-vercel-ai-sdk-elements","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.8,"category":"Skip","description":"","reasoning":"just-bash is one component in a broader RAG+memory+UI stack alongside LlamaParse, Mastra, and AI Elements. Fails is_subject_focused — it's a full-stack application template where just-bash is not central to its identity."},{"repo":"sumedhkhodke/postgres-vfs","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.93,"category":"Filesystem Adapters","description":"PostgreSQL-backed `IFileSystem` with per-tenant row isolation, full-text search, optional pgvector semantic search, and a built-in Web UI — 70+ Unix commands backed by SQL","reasoning":"All checks pass: has_package_dep is true, README clearly describes a just-bash IFileSystem adapter with rich original documentation, has a homepage, stars, and CI badge confirming real published code."},{"repo":"tobowers/minimal-just-bash-failure","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":false,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.95,"category":"Skip","description":"","reasoning":"This is a minimal bug reproduction repo demonstrating a js-exec issue in just-bash. It's not a library, integration, or project — it's a one-off issue repro that adds no value to an awesome list."},{"repo":"vercel-labs/wterm","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.82,"category":"Skip","description":"","reasoning":"wterm is a full web terminal emulator (Zig+WASM) with just-bash as one of several packages (`@wterm/just-bash`). Fails is_subject_focused — just-bash is not central to wterm's identity; it's primarily a terminal emulator project."}]} From 262a9f4ff7d12efe18db367ff377f477eead54e2 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 29 Apr 2026 03:41:23 +0000 Subject: [PATCH 2/2] [discover] apply 3 checked project(s) - MauricioPerera/just-bash-data (Libraries) - nathan-gage/pydantic-ai-just-bash (Integrations) - sumedhkhodke/postgres-vfs (Filesystem Adapters) --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 0fd4f6e..c173e79 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,7 @@ just-bash ships with `InMemoryFs`, `OverlayFs`, `ReadWriteFs`, and `MountableFs` - [bash-gres](https://github.com/marcoripa96/bash-gres) — PostgreSQL-backed `IFileSystem` with workspace isolation via row-level security, BM25 full-text search, and optional pgvector semantic/hybrid search. Works with `postgres.js` or Drizzle. ![](https://img.shields.io/github/stars/marcoripa96/bash-gres?style=flat-square&label=%20&color=gray) - [just-bash-postgres](https://github.com/F1nnM/just-bash-postgres) — Second Postgres filesystem provider using ltree hierarchy, full-text search, pgvector semantic/hybrid search, and per-session row-level security. ![](https://img.shields.io/github/stars/F1nnM/just-bash-postgres?style=flat-square&label=%20&color=gray) - [durable-bash](https://github.com/StableModels/durable-bash) — Cloudflare Durable Object-backed `IFileSystem` adapter. Persists bash command output in a Durable Object's SQLite storage; 121 tests, full `IFileSystem` interface coverage, ships as `@stablemodels/durable-bash`. ![](https://img.shields.io/github/stars/StableModels/durable-bash?style=flat-square&label=%20&color=gray) +- [postgres-vfs](https://github.com/sumedhkhodke/postgres-vfs) — PostgreSQL-backed `IFileSystem` with per-tenant row isolation, full-text search, optional pgvector semantic search, and a built-in Web UI — 70+ Unix commands backed by SQL. ![](https://img.shields.io/github/stars/sumedhkhodke/postgres-vfs?style=flat-square&label=%20&color=gray) ## Libraries @@ -49,6 +50,7 @@ Helper packages for building on top of just-bash. - [just-bash-util](https://github.com/blindmansion/just-bash-util) — Type-safe CLI command framework for `defineCommand`. Subcommands with option inheritance, auto-generated `--help`, typo suggestions, and a `command()` builder reminiscent of commander/yargs. ![](https://img.shields.io/github/stars/blindmansion/just-bash-util?style=flat-square&label=%20&color=gray) - [just-git](https://github.com/blindmansion/just-git) — Pure-TypeScript git implementation with 36 commands that plugs into just-bash as a custom command — pipes, redirects, and `&&` chaining work natively. Also ships a standalone embeddable git server with HTTP/SSH/in-process transport and pluggable storage (SQLite, Postgres, Durable Objects). ![](https://img.shields.io/github/stars/blindmansion/just-git?style=flat-square&label=%20&color=gray) +- [just-bash-data](https://github.com/MauricioPerera/just-bash-data) — Plugin adding `db` (MongoDB-style document store) and `vec` (vector similarity search) commands to just-bash, with JWT auth, RBAC, and AES-256-GCM encryption. ![](https://img.shields.io/github/stars/MauricioPerera/just-bash-data?style=flat-square&label=%20&color=gray) ## Integrations @@ -57,6 +59,7 @@ Helper packages for building on top of just-bash. - [just-bash-mcp](https://github.com/dalist1/just-bash-mcp) — MCP server exposing a sandboxed just-bash environment to any MCP client. ![](https://img.shields.io/github/stars/dalist1/just-bash-mcp?style=flat-square&label=%20&color=gray) - [convex-sandbox](https://github.com/wantpinow/convex-sandbox) — Persistent bash sandboxes backed by Convex file storage. Lazy filesystem hydration, mutation-diffing writeback, and session-persisted `cwd` — no VMs or containers. ![](https://img.shields.io/github/stars/wantpinow/convex-sandbox?style=flat-square&label=%20&color=gray) - [just-bash-mcp](https://github.com/guillaumemaka/just-bash-mcp) — Second MCP server wrapping just-bash with Laminar observability tracing, configurable timeouts, and VS Code MCP integration support. ![](https://img.shields.io/github/stars/guillaumemaka/just-bash-mcp?style=flat-square&label=%20&color=gray) +- [pydantic-ai-just-bash](https://github.com/nathan-gage/pydantic-ai-just-bash) — PydanticAI toolset wrapping just-py-bash as a persistent shell capability, exposing wrapped tools as bash commands with deferred loading and long-lived virtual filesystem. ![](https://img.shields.io/github/stars/nathan-gage/pydantic-ai-just-bash?style=flat-square&label=%20&color=gray) ## Built With just-bash