132 lines
4.1 KiB
Markdown
132 lines
4.1 KiB
Markdown
# 🏺 reliquary
|
|
|
|
A marketplace for personal agent tooling — skills, plugins, prompts, configs — for [Claude Code](https://docs.claude.com/en/docs/claude-code) and, over time, other coding agents.
|
|
|
|
The repo doubles as a **Claude Code marketplace** (`.claude-plugin/marketplace.json`) and a plain git tree you can cherry-pick from. It is built to grow themed plugins and to host non-Claude formats (AGENTS.md bundles, MCP servers, Codex/Gemini/OpenCode skills) in parallel.
|
|
|
|
## 🧩 Plugins
|
|
|
|
| Plugin | Description |
|
|
|---|---|
|
|
| 🧠 [`g4b_ai`](./plugins/g4b_ai) | Core personal Claude Code skills — workpad, research-tree, implementation-orchestration, markdown-embedded-svg |
|
|
| 🐸 [`gitea`](./plugins/gitea) | Gitea issue tracker integration — fetch, create, close, and comment on tickets via self-contained `uv run` scripts |
|
|
| 🦀 [`dioxus`](./plugins/dioxus) | Per-version API reference skills for the Dioxus Rust UI library (currently 0.7+) |
|
|
| 📦 [`project-uv`](./plugins/project-uv) | Context-aware uv project detection — probes layout before suggesting `uv run` / `uv sync` |
|
|
|
|
## 🚀 Install as a Claude Code marketplace
|
|
|
|
```
|
|
/plugin marketplace add git@git.g4b.org:dirigence/reliquary.git
|
|
/plugin install g4b_ai@reliquary
|
|
```
|
|
|
|
Or declaratively in a project's `.claude/settings.json`:
|
|
|
|
```json
|
|
{
|
|
"extraKnownMarketplaces": {
|
|
"reliquary": {
|
|
"source": {
|
|
"source": "git",
|
|
"url": "git@git.g4b.org:dirigence/reliquary.git"
|
|
}
|
|
}
|
|
},
|
|
"enabledPlugins": {
|
|
"g4b_ai@reliquary": true
|
|
}
|
|
}
|
|
```
|
|
|
|
From a local clone:
|
|
|
|
```
|
|
/plugin marketplace add /path/to/reliquary
|
|
/plugin install g4b_ai@reliquary
|
|
```
|
|
|
|
Each plugin's own README documents its skills and any per-plugin install paths.
|
|
|
|
## Install as a Codex marketplace
|
|
|
|
Reliquary also publishes Codex-native plugin metadata via `.agents/plugins/marketplace.json` and per-plugin `.codex-plugin/plugin.json` manifests.
|
|
|
|
From the git marketplace:
|
|
|
|
```sh
|
|
codex plugin marketplace add git@git.g4b.org:dirigence/reliquary.git
|
|
codex plugin add g4b_ai@reliquary
|
|
```
|
|
|
|
From a local clone:
|
|
|
|
```sh
|
|
codex plugin marketplace add /path/to/reliquary
|
|
codex plugin add g4b_ai@reliquary
|
|
```
|
|
|
|
Or declaratively in a project's `.codex/config.toml`:
|
|
|
|
```toml
|
|
[marketplaces.reliquary]
|
|
source_type = "git"
|
|
source = "git@git.g4b.org:dirigence/reliquary.git"
|
|
|
|
[plugins."g4b_ai@reliquary"]
|
|
enabled = true
|
|
```
|
|
|
|
From a local clone:
|
|
|
|
```toml
|
|
[marketplaces.reliquary]
|
|
source_type = "local"
|
|
source = "/path/to/reliquary"
|
|
|
|
[plugins."g4b_ai@reliquary"]
|
|
enabled = true
|
|
```
|
|
|
|
Codex project config is read only for trusted projects. Codex does not currently have a direct `settings.local.json` equivalent; use user-level `~/.codex/config.toml`, profiles, or an intentionally gitignored local workflow for machine-private settings.
|
|
|
|
## ✂️ Grab pieces independently
|
|
|
|
A skill is just a folder containing `SKILL.md`. You don't need the plugin or marketplace machinery to use one:
|
|
|
|
```sh
|
|
git clone git@git.g4b.org:dirigence/reliquary.git /tmp/reliquary
|
|
mkdir -p ~/.claude/skills
|
|
cp -r /tmp/reliquary/plugins/g4b_ai/skills/workpad ~/.claude/skills/
|
|
```
|
|
|
|
Symlink instead of copy if you want to follow upstream:
|
|
|
|
```sh
|
|
ln -s /tmp/reliquary/plugins/g4b_ai/skills/workpad ~/.claude/skills/workpad
|
|
```
|
|
|
|
## 🗂️ Layout
|
|
|
|
```
|
|
reliquary/
|
|
├── .agents/
|
|
│ └── plugins/
|
|
│ └── marketplace.json # Codex marketplace listing
|
|
├── .codex/
|
|
│ └── config.toml # Codex project plugin setup
|
|
├── .claude/
|
|
│ └── settings.json # Claude project plugin setup
|
|
├── .claude-plugin/
|
|
│ └── marketplace.json # Claude marketplace listing
|
|
├── plugins/
|
|
│ ├── g4b_ai/ # 🧠 core skills
|
|
│ ├── gitea/ # 🐸 gitea issue tracker
|
|
│ ├── dioxus/ # 🦀 rust dioxus library reference
|
|
│ └── project-uv/ # 📦 uv project detection
|
|
└── docs/
|
|
```
|
|
|
|
## 📐 Conventions
|
|
|
|
Commit messages use gitmoji prefixes — see [`docs/workpad/specs/commit-conventions.md`](./docs/workpad/specs/commit-conventions.md).
|