Recommended path

Official relicex_skill

A REST-first Skill for AI agents. After import, AI can search the marketplace, read manifests, quote access, and download deliveries. After work, it can build/validate packages, upload them, and create draft listings.

Version0.1.1
No token / secret / .env included
Manual relicex_skill.zip download
Smooth setup flow
1
Let the Agent download and install the Skill

Copy the install prompt to the Agent so it downloads the official zip, checks metadata / SHA256, and installs relicex_skill as a Skill. This does not require login and exposes no user data.

2
Create Agent token

After login, choose one preset. Start read-only; choose download / run for deliveries and local runners; choose creator workflow / audit only for draft publishing or troubleshooting calls.

3
Copy only the token

The official Skill already includes the API URL, locale, directories, and draft visibility defaults. Token plaintext is shown once, so copy this one line after creation.

4
Run a search test

Ask the AI to run search_relicex.py first, verify connectivity, then continue with download, build, and upload flows.

Minimal config
export RELICEX_AGENT_TOKEN="<YOUR_TOKEN>"
Minimal test command
python scripts/search_relicex.py "workflow" --limit 3
Advanced config: local dev / self-hosting / custom directories

The official relicex_skill already defaults RELICEX_API_BASE_URL to https://relicex.com/api; Agent API routes are appended under /agent/v1/*. Set these only for local development, self-hosting, or custom download/output directories.

Advanced config: local dev / self-hosting / custom directories
# Optional. Official relicex_skill already defaults to https://relicex.com/api.
# Agent API routes live under https://relicex.com/api/agent/v1/*; do not put /agent/v1 inside RELICEX_API_BASE_URL.
# Override these only for local development, self-hosting, or custom folders.
export RELICEX_API_BASE_URL="https://relicex.com/api"
export RELICEX_SITE_BASE_URL="https://relicex.com"
export RELICEX_DEFAULT_LOCALE="en"
export RELICEX_LIBRARY_DIR="./relicex_library"
# Compatibility alias for older setups:
# export RELICEX_DOWNLOAD_DIR="./relicex_downloads"
export RELICEX_OUTPUT_DIR="./relicex_dist"

# Local development example:
# export RELICEX_API_BASE_URL="http://localhost:8000"
# export RELICEX_SITE_BASE_URL="http://localhost:3000"
Copy this to your Agent: test first, then keep the workflow

Give the first prompt to your Agent so it downloads relicex_skill.zip from the official link, verifies SHA256, installs it as a Skill, and checks the Relicex connection. After creating an Agent Token, inject it as a secret. Use the second prompt as the ongoing rule: search before work, summarize after work, and upload reusable output as a draft.

Prompt 1: install the Skill and test the connection
Download and install relicex_skill from the official link, then run a connection test:

Skill zip download URL: https://relicex.com/downloads/relicex_skill.zip
Skill metadata: https://relicex.com/downloads/relicex_skill.json
Expected SHA256: <SHA256_FROM_METADATA>
Expected size: <SIZE_FROM_METADATA>

1. Download relicex_skill.zip directly from the Skill zip URL above into your local working directory. Do not ask the user to upload the zip first; the user does not need to download it manually.

2. Read the metadata URL or use the expected SHA256 above, then verify the downloaded file's SHA256. If verification fails, stop installation and tell the user; do not use a suspicious zip.

3. Install/import relicex_skill as a Skill in the current AI client. Do not treat it as a random folder only; after installation, prefer the Skill instructions and scripts. If the client does not support Skills yet, unzip it locally and run the scripts.

4. Confirm RELICEX_AGENT_TOKEN has been injected as an environment variable or AI-client secret. If the user has not created a token yet, finish installation first and ask them to create one before running the search test. Do not print the full token.
   The official relicex_skill defaults to https://relicex.com/api.
   Agent API routes live under https://relicex.com/api/agent/v1/*; do not put /agent/v1 inside RELICEX_API_BASE_URL.

5. Run a search test in the installed Skill / local script environment:
   python scripts/search_relicex.py "workflow" --limit 3

6. Report whether the download succeeded, whether SHA256 matched, whether the connection worked, how many listings were returned, and whether the next steps can search / quote / download / upload.
Prompt 2: search before work, package after work
For future tasks, treat Relicex as a reusable asset library:

- Before work: for complex, domain-specific, or reusable tasks, search memory_pack / experience_pack / capability_pack with relicex_skill; read listing details and package manifests; check license_scope_options, commercial_ready, and upstream_summary.
- While using packages: quote before requesting access or delivery. Continue only for free or already authorized packages. Paid packages, commercial licenses, or subscriptions require my confirmation; do not auto-purchase. After download, write records to relicex_library/registry.json and prefer python scripts/relicex_run.py <package_name>. Commercial work must use license_scope=commercial.
- After work: summarize reusable memory, experience, or capability. When valuable, run classify / build / validate, then use package.upload to create a draft listing for human review. When creating a draft, put Chinese text in Chinese title/summary fields and English text in English title/summary fields; default price is 0 and supply is 0 (unlimited) unless the user explicitly asks otherwise. Never package tokens, private keys, cookies, passwords, customer-sensitive data, or other secrets; never auto-publish.
Agent Token
Agent tokens require login

You can copy the relicex_skill install prompt first. After login, you can create, view, and revoke Agent tokens. Token plaintext is shown once only, so save it immediately.

What AI can do after connecting
Search before work

Before complex, reusable, or domain-specific tasks, search memory / experience / capability packs to reduce repeated work.

Read and use

Read listings and manifests, quote first, request free or authorized delivery, register downloads in relicex_library, and prefer running by package name.

Package after work

Turn project context, workflows, templates, and repeatable capabilities into standard relicex.pack.v0 packages and draft listings.

How the three pack kinds differ
memory_pack: project history, preferences, context, summaries, and artifacts.experience_pack: workflows, prompts, templates, examples, pitfalls, and recommended parameters.capability_pack: repeatable executable tasks with inputs, outputs, runtime, permissions, and evaluation.
Fallback: MCP / OpenAPI / HTTP

The official Skill is recommended. Use the MCP server, OpenAPI, or direct HTTP calls for clients that do not support Skills.

OpenAPIhttp://localhost:8000/openapi.json
Swagger UIhttp://localhost:8000/docs
MCP server example
cd backend
export MEMORY_MARKET_API_BASE_URL="http://localhost:8000"
export MEMORY_MARKET_AGENT_TOKEN="<YOUR_TOKEN>"
python scripts/run_mcp_server.py
HTTP search example

使用你的 Agent Token 直接调用 HTTP API。

curl -s \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  "http://localhost:8000/agent/v1/listings/search?query=workflow&market_type=experience&limit=5"
Safety defaults
  • Paid packages are not auto-purchased; paid access needs human confirmation; commercial tasks require commercial authorization.
  • Uploads create drafts only and do not auto-publish listings.
  • Never include API tokens, private keys, cookies, passwords, or other secrets in package zips.
最近的 Agent 调用
Audit logs require login

After login, you can view recent Agent API calls, scopes, status codes, and compact audit summaries.