AGENTS.mdA

AGENTS.md from soliplex/soliplex is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add soliplex/soliplex/AGENTS.md@git:20261021.3ba0721

Pins git:20261021.3ba0721 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
soliplex/soliplex
Path
AGENTS.md
Versions recorded
13
Latest version
git:20261021.3ba0721, committed Oct 21, 2026
First version recorded
Aug 14, 2026
Size
21,651 bytes
Repository stars
16
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md

Guidance for AI coding agents working on the Soliplex project. Human
contributors should read [DEVELOPMENT.md](DEVELOPMENT.md), which covers the
same ground in prose. (`CLAUDE.md` is a thin stub that imports this file so
Claude Code loads it automatically.)

## Project Overview

Soliplex is an AI-powered RAG system with a FastAPI backend, Flutter web
frontend, and terminal UI. It provides semantic document retrieval,
multi-room chat, and multi-provider LLM support.

**This repository contains the Python backend and TUI only.** The Flutter
frontend lives in a sibling repo at <https://github.com/soliplex/frontend>
with its own tooling.

## Build and Test

```bash
# Install dependencies (use uv, not pip)
uv sync --group dev

# Run unit tests with 100% coverage requirement
uv run pytest

# Run a specific test file / test.  '--no-cov' is required: 'addopts'
# always applies the 100% gate, which a partial run cannot satisfy.
uv run pytest --no-cov tests/unit/test_agents.py
uv run pytest --no-cov tests/unit/test_agents.py::test_name

# Run the unit tests in parallel (pytest-xdist); see below for '-n'
uv run pytest -n 8
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add soliplex/soliplex/AGENTS.md@sha256:931213eafbe81ca6

The line at the top of this page pins the label git:20261021.3ba0721, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_zou6kfm2jf7bczqa.svg)](https://markdownregistry.com/a/art_zou6kfm2jf7bczqa)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 13 versions of this file, between Aug 14, 2026 and Oct 21, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261021.3ba0721 latest2026-10-21 3ba0721 21,651 BA view · diff
git:20261012.0e7bb972026-10-12 0e7bb97 21,168 BA view · diff
git:20261010.c1ec8e12026-10-10 c1ec8e1 21,041 BA view · diff
git:20260924.57f45d72026-09-24 57f45d7 20,859 BA view · diff
git:20260924.30b34732026-09-24 30b3473 19,484 BA view · diff
git:20260922.5dd0b2c2026-09-22 5dd0b2c 19,170 BA view · diff
git:20260922.e880f132026-09-22 e880f13 18,529 BA view · diff
git:20260919.8b574f52026-09-19 8b574f5 17,724 BA view · diff
git:20260917.b61e8b92026-09-17 b61e8b9 17,730 BA view · diff
git:20260917.ec0f6a62026-09-17 ec0f6a6 17,371 BA view · diff
git:20260910.77cf2f62026-09-10 77cf2f6 13,677 BA view · diff
git:20260903.6d005e22026-09-03 6d005e2 12,409 BA view · diff
git:20260814.256214d2026-08-14 256214d 7,760 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (21651 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

soliplex/soliplex · 16 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zou6kfm2jf7bczqa
GET https://markdownregistry.com/api/v1/resolve?ref=soliplex/soliplex/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/931213eafbe81ca6e51e499b328377529d804e092a1d0b976ba0da36129873a4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from soliplex/soliplex

CLAUDE.md CLAUDE.md file
soliplex/soliplex · CLAUDE.md
git:20260601.86790aa · audit A · 16 stars
bare-bones SKILL.md skill
soliplex/soliplex · example/skills/bare-bones/SKILL.md · Wheedle for more resources
git:20261105.680c1c3 · audit B · 16 stars
stanzas SKILL.md skill
soliplex/soliplex · example/skills/stanzas/SKILL.md · Answer questions about a poem: quote a stanza or section verbatim, count stanzas or lines, list sections, find which…
git:20260730.68c219e · audit A · 16 stars
soliplex-docs SKILL.md skill
soliplex/soliplex · skills/soliplex-docs/SKILL.md · Soliplex documentation: how to install, configure, run, and use Soliplex -- a self-hosted RAG/AI system with a FastAPI…
git:20260617.d299aea · audit A · 16 stars
bwrap_sandbox SKILL.md skill
soliplex/soliplex · src/soliplex/skills/bwrap_sandbox/SKILL.md · Run shell commands and Python in a sandbox, to compute results from files rather than estimating them, with read-only…
git:20260928.9f44fd2 · audit A · 16 stars

Every file in soliplex/soliplex

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.