PixivBiu is a Pixiv client for browsing artworks, users, rankings, collections, and followed accounts, with filtering and downloads for original images, multi-image works, and animations. It is used by people who want a desktop or server-based interface for searching and downloading Pixiv content. The catalogue entries provide instructions for working with the project.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/txperl/pixivbiu/agents-mdgit clone --depth 1 https://github.com/txperl/PixivBiuWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/txperl/pixivbiu/agents-md)<a href="https://agentmods.dev/instructions/txperl/pixivbiu/agents-md"><img src="https://agentmods.dev/badge/instructions/txperl/pixivbiu/agents-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.21587 | $0.21587 |
| Opus 5 | $0.10793 | $0.10793 |
| Sonnet 5 | $0.04317 | $0.04317 |
| Haiku 4.5 | $0.02159 | $0.02159 |
Grade A, and why
PixivBiu AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
├── cmd/healthcheck/main.go # Tiny static HTTP probe for the Docker HEALTHCHECK (distroless has no shell/curl) How it starts
The opening of the file, as written. The whole thing — 464 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Project Overview
PixivBiu is a Pixiv artwork browsing, searching, and downloading tool. v3 is its next major version, adopting Go as the implementation language and evolving the project structure to a decoupled backend + frontend monorepo.
The current backend covers auth + read-only browsing + bookmark/follow + download + SSE event stream (all backed by github.com/txperl/pixivgo), plus version reporting & one-click self-update from GitHub Releases (minisign-verified on official builds), and a same-origin image proxy with on-disk cache. Search cache and SauceNAO remain intentionally deferred.
Architecture Overview
| Component | Tech Stack | Default Port | Description |
|---|---|---|---|
| Backend | Go + chi + oapi-codegen | 4001 | REST API server (binds 127.0.0.1 by default). OpenAPI-first: routes and types generated from api/openapi.yaml. |
| Frontend | React 19 + Vite + TypeScript | 5173 (dev) | SPA. Talks to backend via /api/v1/*. |
For production the built SPA is embedded into the Go binary (go:embed, internal/web) and served by the same server at /, so a release is a single self-contained executable and the frontend calls /api same-origin (no CORS). The Vite dev server (5173) only applies during development, proxying /api → 4001. See Build & Release.
Tech Stack
Backend (Go)
- Language: Go 1.26
- Router: chi v5 — lightweight, idiomatic HTTP router
- API codegen: oapi-codegen v2 — generates types + chi server interface from OpenAPI 3 spec. Installed as a
go tool(Go 1.24+ tool directive). - Config: koanf v2 — providers for confmap (defaults + file layer) and env. The settings file is JSON (
usr/settings.json), loaded by an in-packageStoreinstead of koanf's file/yaml providers; the same Store + a reflected schema power the/config/*REST surface. - Logging:
log/slog(stdlib) + go-chi/httplog v3 — HTTP access logs go through httplog middleware; all events aligned to ECS schema (SchemaECS+ReplaceAttron the slog handler) - Decode hooks:
github.com/go-viper/mapstructure/v2(fortime.Durationparsing) - Animated WebP: HugoSmits86/nativewebp — pure Go, zero cgo, used for ugoira → animated WebP
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +20 lines · +1,603 tokens per session 338ceb30ea8a
- 6d ago First seen · 444 lines · 19,984 tokens per session scan A 607d3449452b
PixivBiu AGENTS.md is an instructions file published in the GitHub repository txperl/PixivBiu (1,445 stars, last pushed yesterday), licensed MIT. It adds 21,587 tokens to every session, about $0.1079 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
semiotic CLAUDE.md
Claude Code instructions for nteract/semiotic, covering semiotic claude code instructions and claude code notes.
ai AGENTS.md
AGENTS.md instructions for vercel/ai, covering agents.md, project overview, repository structure, key directories and core package dependencies.
pip-web CLAUDE.md
Claude Code instructions for playpip/pip-web, covering claude.md — agent guide for pip, read first (by task), the three layers (respect the boundaries), non-negotiables and commands / definition of done.
rush AGENTS.md
Instructions for onurhan1337/rush, covering project rules for ikas app starter app (next.js), core principles, stack overview, mcp usage and graphql and api workflow.
tanstack-start-template AGENTS.md
AGENTS.md instructions for dyeoman2/tanstack-start-template, covering tanstack start agent guide, core philosophy, architecture, golden rules and key patterns.
next-sanity CLAUDE.md
Claude Code instructions for sanity-io/next-sanity, a project described as: Sanity toolkit for Next.js.