An autonomous agent framework for crypto traders. VIGIL runs on a GitHub Actions clock, executes markdown skills, and casts prophecies straight to your channels — whale moves, liquidation cascades, narrative shifts, the things you miss while you sleep.
↳ no signup, fork the repo
Markets move on a clock you can't keep. VIGIL keeps it for you — three principles make the watch hold.
VIGIL is not a dashboard you remember to open. It's a scheduled runtime. Every skill carries its own cron — every four hours, every block, every funding window — and fires without a human in the loop.
The agent wakes, gathers state, reasons over it, and sleeps. If a whale moves at 03:47 UTC, the beacon is already lit before your alarm. No babysitting, no missed candles.
See the runtime →
Skills are plain markdown — YAML frontmatter, a prompt body, a
schedule. No SDK, no compiler. Fork the repo, drop a new
SKILL.md into the folder, and the scheduler picks it
up on the next run.
Skills read each other's memory. whale-watch flags an
address; kol-tracker cross-references it; the
narrative scanner ties it to a ticker. Edge compounds.
The core is free and open forever — eight production skills, the scheduler, the runner. No wall on the fundamentals.
$VGL holders unlock the prophecy-* tier:
pre-market hunting, on-chain anomaly detection, and the heavier
models. Hold the key, light the deeper beam — verified on-chain at
run time.
One markdown file in. One beacon out. Here is
whale-watch — the file on the left, the run on the
right.
1--- 2name: whale-watch 3tier: free 4schedule: "0 */4 * * *" # every 4h 5chains: [solana, ethereum] 6threshold_usd: 250000 7outputs: [telegram, slack] 8--- 9 10# Whale Watch 11 12You are a whale-tracking analyst. Each run: 13 141. Pull transfers above threshold_usd 15 from the indexer, last 4 hours. 162. Drop known CEX wallets and routers 17 via memory/known-wallets.json. 183. Cluster remaining flows by entity. 19 Flag wallets moving one direction. 204. Cross-check tickers against the 21 narrative-scanner memory. 22 23## Output 24 25Emit one beacon per cluster: address, 26net USD, direction, one-line read. 27Stay terse. No advice. Signal only.
03:47:01 [INFO] skill whale-watch started 03:47:01 [INFO] window 23:47 → 03:47 UTC 03:47:03 [INFO] pulled 412 transfers > $250k 03:47:04 [INFO] filtered 389 CEX / router hops 03:47:06 [WARN] cluster of 4 wallets, one entity 03:47:06 [INFO] entity tag: "early-SOL-LP" 03:47:08 [HIT ] net accumulation detected addr 7xKpL2…q9Fv3R flow +$1,840,200 ▲ IN asset JUP · 6 buys, 0 sells 03:47:10 [INFO] narrative match: "perp DEX szn" 03:47:11 [INFO] formatting beacon → telegram 03:47:12 [DONE] Beacon sent · 1 cluster · 11.4s _
Schedule, chains, thresholds and outputs — declarative config the scheduler reads without running the skill.
Plain instructions. The runner hands this to the model with the gathered on-chain state attached.
Skills read and write a shared JSON memory folder, so context survives between runs and across skills.
The single structured output — pushed to Telegram or Slack the moment the run completes.
Eight in the free core. Twenty-four more in the prophecy tier. Each runs on its own clock and writes to the same memory.
Tracks large transfers, clusters them by entity, and flags one-directional accumulation.
7xKpL2…q9Fv3R +$1.84M ▲ JUP
Maps open-interest leverage clusters and warns before a cascade level is hit.
BTC long liq wall · $61,420 · $88M
Compares perp funding across venues and surfaces delta-neutral carry windows.
HYPE +0.092% / -0.011% · 4 venues
Reads social and news velocity, then ranks emerging narratives by acceleration.
"RWA rotation" · velocity ▲ 3.4×
Watches a curated set of wallets and accounts, scoring conviction by follow-through.
3 KOL wallets entered WIF · 18m span
Detects fresh pools with credible liquidity and clean deployer history.
new pool · $214k LP · deployer clean
Hunts pre-listing and pre-TGE flow signals before they reach public order books.
OTC bid stack thickening · 2 desks
Flags on-chain behaviour that breaks an address's own historical pattern.
dormant 412d wallet · sudden 9 txns
24 more skills in the prophecy tier — unlock calendar, bridge monitor, governance watch and beyond. See $VGL access →
No servers, no infrastructure bill. Your fork runs on GitHub Actions minutes.
Fork the VIGIL repository to your own account. You get the scheduler, the runner, eight production skills and the shared memory folder. Enable Actions and the clock starts.
# clone your fork and enter the watch $ gh repo fork vigil-oracle/vigil --clone $ cd vigil $ gh workflow enable scheduler.yml ✓ scheduler armed · next run in 04:00:00
Edit one config file. Point VIGIL at your output channels, set
your thresholds, switch skills on or off. Drop your own
SKILL.md files in to extend the watch.
watcher: name: "night-desk" outputs: telegram: "${TG_CHAT_ID}" skills: whale-watch: { enabled: true } liquidation-radar: { enabled: true } funding-arb: { enabled: false }
Close the laptop. VIGIL runs on schedule, reasons over fresh on-chain state, and sends beacons the moment something matters. You read signal, not noise.
03:47 ◈ BEACON · whale-watch Net accumulation flagged. 7xKpL2…q9Fv3R +$1.84M JUP Read: aligns with perp-DEX narrative. 04:02 ◈ BEACON · liquidation-radar BTC long wall at $61,420 · $88M
Six moving parts. No private servers. Every run is a public, auditable Actions log.
┌──────────────────────────┐ │ GITHUB ACTIONS · CRON │ └────────────┬─────────────┘ ▼ ┌──────────────────────────┐ │ SCHEDULER │ └────────────┬─────────────┘ ▼ ┌──────────────────────────┐ │ SKILL RUNNER │ └──────┬────────────┬──────┘ ▼ ▼ ┌───────────┐ ┌───────────┐ │ REASONING │ │ SKILLS/MEM│ │ ENGINE │◄│*.md·*.json│ └─────┬─────┘ └───────────┘ ▼ ┌──────────────────────────┐ │ OUTPUT │ │TELEGRAM · WEBHOOK · SLACK│ └──────────────────────────┘
GitHub's scheduler is the heartbeat. The Scheduler reads each skill's frontmatter and dispatches only what is due. The Runner assembles on-chain state and shared memory, hands it to the reasoning engine, and the structured beacon it returns is pushed to your channels. The whole loop is stateless — memory lives as committed JSON, so any run can be replayed or audited from the git history alone.
A real-time cycle through five skills as they fire. Mock data, real format.
$VGL does one job and does it cleanly: it gates the
prophecy-* skill tier. No staking maze, no emissions, no
governance theatre at launch. Hold the token, your fork verifies the
balance on-chain at run time, and the premium skills light up. The
free core never asks for it.
prophecy-* skillsA general agent is broad. A centralized bot is rented. Manual is slow. VIGIL is specialized, owned, and awake.
| Criteria | VIGIL ORACLE | Aeon general agent | Centralized bots 3Commas-class | Manual trading |
|---|---|---|---|---|
| Cost | Free coreActions minutes only | Freeopen framework | Subscription$30–100 / mo | Timeyour hours |
| Customization | Fullmarkdown skills | Fullbut unfocused | Presetslocked logic | Totalbut unscaled |
| Privacy | Self-hostedyour repo, your keys | Self-hostedyour infra | CustodialAPI keys shared | Privatenothing shared |
| Speed | Scheduleddown to 5-min cron | Manualyou prompt it | Real-timealways on | Humanyou must be awake |
| Edge skills | Trading-nativebuilt for this | Genericnot domain-tuned | TA onlyindicator presets | Your skillcaps at you |
| Self-evolving | Yesskills add skills | Yesgeneral agent | Novendor roadmap | Nostatic habits |
◆ VIGIL borrows Aeon's self-evolving architecture and points all of it at one job — trading intelligence.
Shipped, building, planned. Dates are targets, not promises — the beacon stays lit either way.
Ten honest answers. If yours is missing, the Telegram watch desk is open.
Aeon is a general-purpose self-evolving agent framework — it can be pointed at anything. VIGIL takes that same architecture and specializes it entirely for trading intelligence. Every skill, every memory schema, every output format is built for whale flow, liquidations, funding and narratives. You could rebuild VIGIL on top of Aeon; we did the work so you don't have to.
You don't — for the free core. Eight production skills, the scheduler and the runner are open-source and ungated forever. $VGL only unlocks the prophecy-* tier: pre-market hunting, anomaly detection and the heavier reasoning models. Your fork checks your wallet balance on-chain at run time. No staking, no lockup.
The runner needs a reasoning-model API key, which you supply as a repo secret. The free core is tuned to run cheaply on smaller models — a typical watcher costs a few dollars a month in API usage. The prophecy tier benefits from larger models, but nothing forces you onto them. Bring your own key, set your own budget.
VIGIL reports observations, not predictions. A beacon says "this wallet accumulated $1.84M of JUP" — a verifiable on-chain fact — plus a one-line read for context. It never tells you to buy or sell. Treat every beacon as a lead to verify, not a signal to trade blind. The data is as accurate as the indexers it pulls from; the interpretation is yours.
Zero. VIGIL only reads chain state — it never sends transactions, never signs anything, never touches your funds. There is no wallet connection and no gas. The only running cost is your reasoning-model API usage and, if you exceed the free tier, GitHub Actions minutes.
Yes — that's the core idea. A skill is a single markdown file: YAML frontmatter for schedule and config, a prompt body for instructions. Drop it into the skills/ folder and the scheduler picks it up on the next run. No SDK, no build step. Community skills land in the marketplace in Q3 2026.
The runtime is fully open-source — every line is on GitHub and every run is a public Actions log you can inspect. Because VIGIL holds no funds and signs no transactions, the attack surface is small. Independent security review of the skill sandbox is on the 2027 roadmap; until then, read the code before you fork it.
At launch VIGIL watches Solana and Ethereum for on-chain skills, with funding and liquidation skills covering the major perp venues. Base and Hyperliquid land in Q4 2026. Each skill declares its own chains in frontmatter, so you only run what you care about.
Telegram at launch — set a chat or channel ID in vigil.config.yml and beacons arrive there. Slack and generic webhooks are in progress for Q3 2026. A skill can fan out to multiple channels by listing them in its outputs field.
No. VIGIL runs in your own forked repository, with your own API keys stored as your repo secrets. It never holds your tokens, never connects a wallet for signing, and never routes through our infrastructure. The $VGL balance check is a read-only on-chain query. Your watch is yours alone.
The market does not close. Neither does VIGIL. Fork the watch, hold the key, and let the Oracle keep the hours you can't.
18 MAY 2026 · 3PM UTC · pump.fun · be the first watcher
Always verify the contract address against official channels before interacting. VIGIL provides intelligence, not financial advice.