> ## Documentation Index
> Fetch the complete documentation index at: https://sigil-docs-568611a1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Run it yourself
> Open the hosted app, buy a skill, or run the whole thing locally.
There are three ways in, from fastest to fullest.
## 1. Just open the hosted app
Nothing to install.
Browse the registry, open a skill, press "Request the source" to see the live paywall.
The raw discovery directory the agent reads.
## 2. Buy and run a real skill (one command)
This pays a real testnet micro-payment, takes the licence, and saves the skill's files locally. It targets the hosted gateway out of the box.
```bash theme={null}
git clone https://github.com/sm-xd/sigil && cd sigil
pnpm install
# fill .env with a Hedera testnet operator account (see .env.example)
E2E_FRESH_PAYER=1 pnpm buy slugify
```
You will see the `402`, the payment settle on Hedera, a licence NFT minted, and the files written under `downloads/slugify/`.
## 3. Run the whole loop locally
This runs the full cycle: seed a claim with staked USDC on Arc, then have the agent discover it, pay, probe it in the sandbox, dispute the violation, and settle on-chain. You need Node 22.13, pnpm and Foundry installed.
```bash theme={null}
pnpm install && cp .env.example .env # fill the keys, see RUN.md
pnpm hedera:bootstrap # Hedera topics, licence NFT, agent identity
pnpm deploy # SigilStake + DisputeResolver on Arc testnet
pnpm gateway # the x402 service on :4021
SEED_STAKE_USDC=10 SEED_ONCHAIN_SKILLS=cloud-helper pnpm seed
pnpm web # the ledger UI on :3000
POLICY_MIN_STAKE_USDC=10 POLICY_MIN_CLAIM_AGE_SEC=0 pnpm e2e # the agent, end to end
```
Every command, every environment variable, every expected log line, and the hosted-on-AWS setup are documented in full in the repo's [`RUN.md`](https://github.com/sm-xd/sigil/blob/main/RUN.md).
## The demo
The showpiece is a visitor using a skill that has money behind it:
1. Open **Register a skill**, pick an example (say `git-status`, which shells out), press Register, then **Open a claim on it** with the rule it breaks (`NO_CHILD_PROCESS`).
2. Open the registry, click a skill with USDC staked on Arc.
3. Press **Request the source** — the `402` paywall appears.
4. In a terminal, run `E2E_FRESH_PAYER=1 POLICY_MIN_STAKE_USDC=10 POLICY_MIN_CLAIM_AGE_SEC=0 pnpm e2e`.
5. Watch the payment land, the sandbox find the violation, and the 12.5 USDC pot move on Arc — all on screen.
