getraw 0.1.0 → 0.2.0

package/STATUS.md

@@ -1,4 +1,4 @@
-# dlpx — Agent Status Board
+# getraw — Agent Status Board
 
 Last updated: 2026-06-16
 

package/docs/plugin-guide.md

@@ -1,6 +1,6 @@
 # Plugin Guide — Writing a Custom Extractor
 
-dlpx extractors are classes that extend `BaseExtractor` from `src/core/types.ts`. Once written, they are registered via `registerExtractor` from `src/extractors/base.ts`. dlpx then tries each registered extractor in order before falling back to the generic extractor.
+getraw extractors are classes that extend `BaseExtractor` from `src/core/types.ts`. Once written, they are registered via `registerExtractor` from `src/extractors/base.ts`. getraw then tries each registered extractor in order before falling back to the generic extractor.
 
 ## BaseExtractor Interface
 

package/docs/supported-sites.md

@@ -1,6 +1,6 @@
 # Supported Sites
 
-All extractors implement `BaseExtractor` from `src/core/types.ts`. The `_VALID_URL` regex for each is listed below — dlpx tests URLs against these in registration order, falling back to the `generic` extractor for any `http(s)://` URL.
+All extractors implement `BaseExtractor` from `src/core/types.ts`. The `_VALID_URL` regex for each is listed below — getraw tests URLs against these in registration order, falling back to the `generic` extractor for any `http(s)://` URL.
 
 | # | Extractor name | Site | URL pattern | Formats | Notes |
 |---|---------------|------|-------------|---------|-------|

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "getraw",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Fast media downloader CLI built natively in Bun/TypeScript",
   "type": "module",
   "bin": {
-    "dlpx": "./src/cli/index.ts"
+    "getraw": "./src/cli/index.ts"
   },
   "scripts": {
     "dev": "bun run src/cli/index.ts",
     "test": "bun test",
-    "build": "bun build src/cli/index.ts --compile --outfile=dlpx",
+    "build": "bun build src/cli/index.ts --compile --outfile=getraw",
     "dashboard": "bun run tools/dashboard.ts"
   },
   "dependencies": {
@@ -25,6 +25,6 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/web3mikee/dlpx"
+    "url": "https://github.com/onkits/getraw"
   }
 }

package/skills/getraw/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: getraw
+description: Download videos, audio, and metadata from 30+ sites (YouTube, Twitter, TikTok, Instagram, Reddit, Twitch, Vimeo, SoundCloud, and more). Use when the user asks to download media, extract video info, get transcripts/subtitles, rip audio, or fetch metadata from a URL. Wraps the getraw CLI — a yt-dlp replacement built in Bun/TypeScript.
+---
+
+# getraw
+
+Download and extract media from 30+ sites. Built in Bun/TypeScript as a yt-dlp replacement.
+
+## Prerequisites
+
+Requires `bun` and `getraw` installed:
+
+```bash
+bun install -g getraw
+```
+
+Optional: `ffmpeg` for audio extraction, format merging, and subtitle embedding.
+
+## Commands
+
+### Download a video
+
+```bash
+getraw "URL"
+```
+
+Downloads the best available format to the current directory.
+
+### Get metadata as JSON (no download)
+
+```bash
+getraw --dump-json "URL"
+```
+
+Returns full metadata: title, description, uploader, duration, formats, subtitles, thumbnails. Use this when you need info about a video without downloading it. Parse the JSON output for structured data.
+
+### List available formats
+
+```bash
+getraw --list-formats "URL"
+```
+
+Shows all available quality/format options (resolution, codec, bitrate, filesize).
+
+### Download specific format
+
+```bash
+getraw -f "best[height<=720]" "URL"
+getraw -f "bestvideo+bestaudio" "URL"
+getraw -f "bestaudio" "URL"
+```
+
+Format selection strings:
+- `best` — best single file
+- `bestvideo+bestaudio` — best video + best audio, merged by ffmpeg
+- `bestaudio` — audio only (best quality)
+- `best[height<=720]` — best format at 720p or below
+- Format ID from `--list-formats` (e.g. `137+140`)
+
+### Extract audio only
+
+```bash
+getraw -x "URL"
+getraw -x --audio-format mp3 "URL"
+getraw -x --audio-format flac "URL"
+```
+
+Supported audio formats: `mp3`, `aac`, `flac`, `wav`, `opus`, `vorbis`, `m4a`.
+
+### Download subtitles
+
+```bash
+getraw --write-subs "URL"
+getraw --write-subs --sub-langs "en,es" "URL"
+```
+
+Downloads subtitle files alongside the video. Use `--sub-langs` to specify languages.
+
+### Custom output filename
+
+```bash
+getraw -o "%(title)s.%(ext)s" "URL"
+getraw -o "%(uploader)s - %(title)s [%(id)s].%(ext)s" "URL"
+```
+
+Template variables: `%(title)s`, `%(id)s`, `%(ext)s`, `%(uploader)s`, `%(upload_date)s`, `%(duration)s`, `%(view_count)s`.
+
+### Embed metadata
+
+```bash
+getraw --embed-thumbnail --embed-subs "URL"
+```
+
+Embeds thumbnail art and subtitles into the downloaded file (requires ffmpeg).
+
+## Supported Sites
+
+| Site | URL Pattern |
+|------|------------|
+| YouTube | youtube.com, youtu.be, youtube.com/shorts |
+| Twitter/X | twitter.com/*/status/*, x.com/*/status/* |
+| TikTok | tiktok.com/@*/video/*, vm.tiktok.com/* |
+| Instagram | instagram.com/p/*, instagram.com/reel/* |
+| Reddit | reddit.com/r/*/comments/*, v.redd.it/* |
+| Twitch | twitch.tv/videos/*, twitch.tv/*/clip/* |
+| Vimeo | vimeo.com/* |
+| SoundCloud | soundcloud.com/*/* |
+| Bilibili | bilibili.com/video/* |
+| Dailymotion | dailymotion.com/video/* |
+| Bandcamp | *.bandcamp.com/track/*, *.bandcamp.com/album/* |
+| Rumble | rumble.com/* |
+| TED | ted.com/talks/* |
+| Kick | kick.com/video/*, kick.com/*/clips/* |
+| Streamable | streamable.com/* |
+| PeerTube | Any PeerTube instance |
+| Archive.org | archive.org/details/* |
+| + 13 more | Imgur, Coub, Odysee, Spotify podcasts, NHK, BBC, etc. |
+
+## When to Use
+
+- User says "download this video" or shares a video URL
+- User wants video/audio metadata (`--dump-json`)
+- User wants to extract audio from a video (`-x`)
+- User wants subtitles or transcripts (`--write-subs`)
+- User wants to check available qualities (`--list-formats`)
+- User wants to save media for offline use or processing
+
+## Common Patterns
+
+### Get video transcript for summarization
+
+```bash
+getraw --write-subs --sub-langs en --skip-download "URL"
+# Then read the .vtt or .srt file
+```
+
+### Download audio for TTS/transcription pipeline
+
+```bash
+getraw -x --audio-format wav -o "audio.wav" "URL"
+```
+
+### Batch download from a list
+
+```bash
+getraw URL1 URL2 URL3
+```
+
+### Get metadata for multiple videos
+
+```bash
+for url in URL1 URL2 URL3; do
+  getraw --dump-json "$url"
+done
+```
+
+## Error Handling
+
+- If a site is unsupported, getraw returns a clear error with the URL
+- If a format is unavailable, it falls back to the best available
+- Network errors retry 3 times with exponential backoff
+- Use `--verbose` for debug output, `--quiet` to suppress all output

package/src/cli/index.ts

@@ -15,7 +15,7 @@ async function main(): Promise<void> {
   }
 
   if (options.version) {
-    process.stdout.write(`dlpx ${VERSION}\n`);
+    process.stdout.write(`getraw ${VERSION}\n`);
     process.exit(0);
   }
 

package/src/cli/options.ts

@@ -81,9 +81,9 @@ export function parseArgs(args: string[]): Options {
 
 export function printHelp(): void {
   const lines = [
-    "dlpx — Fast media downloader",
+    "getraw — Fast media downloader",
     "",
-    "Usage: dlpx [OPTIONS] URL [URL...]",
+    "Usage: getraw [OPTIONS] URL [URL...]",
     "",
     "Options:",
   ];

package/src/core/types.ts

@@ -224,7 +224,7 @@ export const DEFAULT_OPTIONS: Options = {
   rateLimit: null,
   proxy: null,
   cookies: null,
-  userAgent: "dlpx/0.0.0",
+  userAgent: "getraw/0.0.0",
   referer: null,
   embedThumbnail: false,
   embedSubs: false,

package/src/downloaders/dash.ts

@@ -119,7 +119,7 @@ export class DashDownloader extends Downloader {
       throw new DownloadError("No segments found in MPD");
     }
 
-    const tempDir = `/tmp/dlpx-dash-${Date.now()}`;
+    const tempDir = `/tmp/getraw-dash-${Date.now()}`;
     const fragmenter = new FragmentDownloader();
     await fragmenter.downloadSegments(allSegments, filepath, {
       ...options,

package/src/downloaders/fragment.ts

@@ -24,7 +24,7 @@ export class FragmentDownloader {
     options: FragmentDownloadOptions,
   ): Promise<void> {
     const concurrency = options.concurrency ?? 8;
-    const tempDir = options.tempDir ?? "/tmp/dlpx-fragments";
+    const tempDir = options.tempDir ?? "/tmp/getraw-fragments";
 
     await Bun.$`mkdir -p ${tempDir}`.quiet();
 

package/src/downloaders/hls.ts

@@ -154,7 +154,7 @@ export class HlsDownloader extends Downloader {
       segments.push(seg);
     }
 
-    const tempDir = `/tmp/dlpx-hls-${Date.now()}`;
+    const tempDir = `/tmp/getraw-hls-${Date.now()}`;
     const fragmenter = new FragmentDownloader();
     await fragmenter.downloadSegments(segments, filepath, {
       ...options,

package/src/downloaders/http.ts

@@ -174,7 +174,7 @@ export class HttpDownloader extends Downloader {
       chunks.push({ start: i, end: Math.min(i + CHUNK_SIZE - 1, totalBytes - 1), index: idx });
     }
 
-    const tempDir = `/tmp/dlpx-http-${Date.now()}`;
+    const tempDir = `/tmp/getraw-http-${Date.now()}`;
     await Bun.$`mkdir -p ${tempDir}`.quiet();
 
     const baseHeaders = this.buildHeaders(options);

package/src/extractors/niconico/index.ts

@@ -126,7 +126,7 @@ export class NiconicoExtractor extends BaseExtractor {
       };
 
       const sessionResp = await fetch(
-        `https://nvapi.nicovideo.jp/v1/watch/${videoId}/access-rights/hls?actionTrackId=dlpx_${Date.now()}`,
+        `https://nvapi.nicovideo.jp/v1/watch/${videoId}/access-rights/hls?actionTrackId=getraw_${Date.now()}`,
         {
           method: "POST",
           headers: {

package/src/extractors/reddit/gallery.ts

@@ -44,7 +44,7 @@ export class RedditGalleryExtractor extends BaseExtractor {
     const jsonUrl = normalized.replace(/\?.*$/, "").replace(/\/$/, "") + ".json";
 
     const response = await fetch(jsonUrl, {
-      headers: { "User-Agent": "dlpx/1.0" },
+      headers: { "User-Agent": "getraw/1.0" },
     });
     if (!response.ok) {
       throw new ExtractorError(`Reddit API returned ${response.status}`);

package/src/extractors/reddit/index.ts

@@ -86,7 +86,7 @@ export class RedditExtractor extends BaseExtractor {
   private async _extractVReddIt(url: string): Promise<InfoDict> {
     const jsonUrl = url.endsWith("/") ? url + ".json" : url + "/.json";
     const response = await fetch(jsonUrl, {
-      headers: { "User-Agent": "dlpx/1.0" },
+      headers: { "User-Agent": "getraw/1.0" },
     });
     if (!response.ok) {
       throw new ExtractorError(`Reddit API returned ${response.status}`);
@@ -104,7 +104,7 @@ export class RedditExtractor extends BaseExtractor {
     const normalized = normalizeRedditUrl(url);
     const jsonUrl = normalized.replace(/\?.*$/, "").replace(/\/$/, "") + ".json";
     const response = await fetch(jsonUrl, {
-      headers: { "User-Agent": "dlpx/1.0" },
+      headers: { "User-Agent": "getraw/1.0" },
     });
     if (!response.ok) {
       throw new ExtractorError(`Reddit API returned ${response.status}`);
@@ -168,7 +168,7 @@ export class RedditExtractor extends BaseExtractor {
           width: videoData.width,
           height: videoData.height,
           format_note: "video+audio (merged)",
-          http_headers: { "User-Agent": "dlpx/1.0" },
+          http_headers: { "User-Agent": "getraw/1.0" },
         });
       }
     }

package/src/extractors/twitter/index.ts

@@ -44,7 +44,7 @@ export class TwitterExtractor extends BaseExtractor {
     const apiUrl = `https://cdn.syndication.twimg.com/tweet-result?id=${tweetId}&lang=en&features=tfw_timeline_list%3A%3Btfw_follower_count_sunset%3Atrue&token=0`;
     const resp = await fetch(apiUrl, {
       headers: {
-        "User-Agent": "Mozilla/5.0 (compatible; dlpx/1.0)",
+        "User-Agent": "Mozilla/5.0 (compatible; getraw/1.0)",
         Accept: "application/json",
         Referer: "https://platform.twitter.com/",
         Origin: "https://platform.twitter.com",

package/src/networking/cookies.ts

@@ -40,7 +40,7 @@ export function parseNetscapeCookieFile(content: string): Cookie[] {
 }
 
 export function serializeNetscapeCookieFile(cookies: Cookie[]): string {
-  const header = "# Netscape HTTP Cookie File\n# Generated by dlpx\n";
+  const header = "# Netscape HTTP Cookie File\n# Generated by getraw\n";
   const lines = cookies.map((c) =>
     [
       c.domain,

package/src/networking/tls.ts

@@ -61,7 +61,7 @@ standard fetch()/WebSocket APIs. Full impersonation requires:
 2. Custom cipher suite ordering matching the target browser
 3. Custom TLS extensions ordering
 
-For now, dlpx sets a matching User-Agent header which satisfies most sites.
+For now, getraw sets a matching User-Agent header which satisfies most sites.
 Sites that perform JA3 fingerprint checking (e.g., some CDN bot detection) may
 require a future implementation using Bun FFI + uTLS or a headless browser approach.
 `;

package/tests/unit/extractors/misc.test.ts

@@ -894,8 +894,8 @@ describe("GoogleDriveExtractor parsing", () => {
     expect(info.id).toBe("1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs");
     expect(info.title).toBe("test-video");
     expect(info.ext).toBe("mp4");
-    expect(info.formats![0].url).toContain("drive.google.com/uc");
     expect(info.formats![0].url).toContain("export=download");
+    expect(info.formats![0].url).toContain("1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs");
     expect(info.formats![0].filesize).toBe(10485760);
   });
 

package/tools/dashboard.ts

@@ -39,7 +39,7 @@ function parseAndRender(content: string): string {
   const output: string[] = [];
 
   output.push("");
-  output.push(`${COLORS.bold}${COLORS.cyan}  dlpx — Agent Dashboard${COLORS.reset}`);
+  output.push(`${COLORS.bold}${COLORS.cyan}  getraw — Agent Dashboard${COLORS.reset}`);
   output.push(`${COLORS.dim}  ${new Date().toLocaleTimeString()}${COLORS.reset}`);
   output.push("");
 

package/video/.hyperframes/expanded-prompt.md

@@ -0,0 +1,173 @@
+# getraw — Product Video Expansion
+
+## Style Block
+
+- **BG:** #0c0c0f (near-black, blue undertone)
+- **FG:** #e8e8ec (off-white)
+- **Accent:** #00ff88 (terminal green)
+- **Surface:** #161620
+- **Muted:** #6b6b80
+- **Headline:** Space Grotesk 700, -0.03em tracking
+- **Code:** JetBrains Mono 400
+- **Labels:** JetBrains Mono 500 uppercase, 0.08em tracking
+
+## Rhythm Declaration
+
+`hook-PUNCH-breathe-BUILD-PEAK-CTA`
+
+6 scenes, ~30 seconds total. Fast hook, slam the name, breathe with the problem, build features, peak with the stats, close with install command.
+
+## Global Rules
+
+- Primary transition: glitch (0.3s) — 60% of transitions
+- Accent transition: staggered blocks (0.25s) — topic changes
+- All decoratives have ambient motion (scan-line drift, grid pulse, cursor blink)
+- Terminal green (#00ff88) used ONLY for: commands, active highlights, key stats
+- Everything else in off-white or muted
+
+---
+
+## Scene 1: Hook (0s–5s)
+
+**Concept:** A terminal cursor blinks on black. A command types out character by character: `$ getraw "https://youtube.com/watch?v=..."`. The moment Enter is hit, the screen EXPLODES with data — format listings cascading down like a matrix waterfall. The viewer's reaction: "what is this tool?"
+
+**Mood:** Cinematic hacker. The opening frame of a tech thriller.
+
+**Depth layers:**
+- BG: #0c0c0f solid + subtle scan-line overlay at 8% opacity drifting upward + faint grid dots at 5% pulsing
+- MG: Terminal text, typing animation, cursor blink
+- FG: Faint terminal frame border (1px #2a2a3a), timestamp label top-right "v0.1.0"
+
+**Animation choreography:**
+- Cursor BLINKS twice (0.5s interval) at t=0.2
+- Command TYPES character-by-character at 40ms/char starting t=0.8
+- On "enter" at t=3.0: format data CASCADES in from top, staggered 30ms per line
+- Scan-lines drift upward continuously
+
+**Transition out:** Glitch, 0.3s, power3.inOut
+
+---
+
+## Scene 2: Name Drop (5s–10s)
+
+**Concept:** The word "getraw" SLAMS into frame at massive scale — 160px, terminal green, filling 70% of the width. Below it, a subtitle types on: "yt-dlp replacement. Built in Bun." The green glows softly, casting light on the dark surface. This is the brand moment.
+
+**Mood:** Impact. Like a logo sting but for a CLI tool.
+
+**Depth layers:**
+- BG: Radial glow from center (#00ff88 at 12% opacity, scale breathing 1.0→1.05) + ghost text "MEDIA DOWNLOADER" at 4% opacity, 200px, behind the title
+- MG: "getraw" headline + subtitle line
+- FG: Two horizontal rules (top and bottom of frame, #2a2a3a, scaleX from 0), version badge "v0.1.0" bottom-right
+
+**Animation choreography:**
+- "getraw" SLAMS from y:80 with scale overshoot (1.05→1.0), expo.out, 0.5s at t=0.3
+- Subtitle TYPES on character-by-character at t=1.2, JetBrains Mono, muted color
+- Horizontal rules DRAW from center outward (scaleX: 0→1) at t=0.5, 0.6s
+- Radial glow BREATHES continuously (scale 1.0↔1.05, 3s loop)
+
+**Transition out:** Staggered blocks, 0.25s — signals topic change
+
+---
+
+## Scene 3: The Problem (10s–15s)
+
+**Concept:** Split frame. Left side: "yt-dlp" with a list of pain points stacking up — "Python dependency", "External JS runtime", "36K line interpreter", "Slow startup". Each appears with a red-ish muted strike. Right side: blank, waiting. The viewer feels the weight of the problem before the solution appears.
+
+**Mood:** Tension. Editorial comparison. The "before" that makes the "after" land.
+
+**Depth layers:**
+- BG: Subtle vertical divider line at center (1px #2a2a3a) + grid dots left half at 5%
+- MG: "yt-dlp" label top-left + stacking pain points + right side empty space
+- FG: Small "THE PROBLEM" label top-center in muted, monospace uppercase
+
+**Animation choreography:**
+- "THE PROBLEM" label FADES in at t=0.2, subtle
+- "yt-dlp" SLIDES in from left at t=0.4
+- Pain points STACK one by one, each DROPPING from y:-20 with stagger 0.3s starting t=0.8
+- Each pain point gets a subtle strikethrough line that DRAWS across after landing
+- Right side stays intentionally empty — tension
+
+**Transition out:** Glitch, 0.3s
+
+---
+
+## Scene 4: The Solution (15s–21s)
+
+**Concept:** The empty right side from scene 3 is now the full frame. "getraw" in green, and below it, three feature cards STAGGER in: "Native JS execution", "30+ site extractors", "Bun-powered CLI". Each card has a small icon-like label and a one-liner. Clean, confident, no clutter. The solution is elegant.
+
+**Mood:** Confidence. Clean resolve after tension.
+
+**Depth layers:**
+- BG: Radial glow bottom-left (#00ff88 at 10%) + faint circuit-board pattern at 3% opacity
+- MG: "getraw" label + three feature cards in surface color (#161620) with border
+- FG: Small arrow indicators (→) next to each card, accent green, appearing with stagger
+
+**Animation choreography:**
+- "getraw" SLIDES in from left at t=0.2, accent green, smaller (64px)
+- Feature cards CASCADE from right, stagger 0.15s, each from x:40 + opacity:0, expo.out
+- Arrow indicators POP in with scale overshoot 0.15s after their card lands
+- Circuit pattern DRIFTS slowly rightward
+
+**Transition out:** Glitch, 0.3s
+
+---
+
+## Scene 5: Stats (21s–26s)
+
+**Concept:** Three big numbers SLAM in simultaneously: "30+" sites, "386" tests, "50ms" startup. Each in massive type (120px), terminal green. Below each number, a label in muted monospace. This is the proof. Numbers don't lie.
+
+**Mood:** Peak energy. Data as spectacle.
+
+**Depth layers:**
+- BG: Three vertical accent lines (#00ff88 at 8%) behind each stat, full height, subtle pulse
+- MG: Three stat columns with numbers + labels
+- FG: "BENCHMARKS" label top-center, monospace uppercase muted + scan-line overlay intensified to 12%
+
+**Animation choreography:**
+- "BENCHMARKS" label FADES in at t=0.1
+- All three numbers SLAM simultaneously from y:60, scale:1.1→1.0, expo.out, 0.4s at t=0.3
+- Labels TYPE on below each number, stagger 0.1s starting t=0.8
+- Accent lines PULSE once on number impact (opacity 8%→15%→8%, 0.6s)
+
+**Transition out:** Staggered blocks, 0.3s — wind down
+
+---
+
+## Scene 6: CTA / Install (26s–30s)
+
+**Concept:** Back to terminal. A clean command prompt: `$ bun install -g getraw`. Below it, the npm badge and GitHub link. The cursor blinks at the end. Simple. The viewer knows exactly what to do next.
+
+**Mood:** Resolution. Clear call to action. The cursor blink is the mic drop.
+
+**Depth layers:**
+- BG: Subtle scan-lines returning + faint radial glow center (#00ff88 at 6%)
+- MG: Install command + npm/GitHub info
+- FG: Terminal frame border, "getraw.dev" bottom-center (aspirational), cursor blinking
+
+**Animation choreography:**
+- Terminal frame DRAWS in (border animation, 0.4s) at t=0.1
+- Command TYPES on at t=0.5, 50ms/char, green text
+- npm line FADES in at t=2.0, muted
+- GitHub URL FADES in at t=2.3, muted
+- Cursor BLINKS indefinitely (well, 4 blinks with calculated repeat count)
+
+**Transition out:** Final scene — elements fade to black over 0.8s. Last thing visible: the blinking cursor.
+
+---
+
+## Recurring Motifs
+
+- Terminal cursor blink (scenes 1, 6)
+- Scan-line overlay (all scenes, varying intensity)
+- Character-by-character typing (scenes 1, 2, 6)
+- Accent green used only for active/important elements
+
+## Negative Prompt
+
+- No gradient text
+- No cyan or purple — green only
+- No rounded corners > 8px
+- No web-UI card shadows
+- No centered-everything layouts
+- No Inter, Roboto, or banned fonts
+- No pure #000 or #fff

package/video/design.md

@@ -0,0 +1,82 @@
+---
+name: getraw
+colors:
+  primary: "#0c0c0f"
+  on-primary: "#e8e8ec"
+  accent: "#00ff88"
+  accent-dim: "#00cc6a"
+  surface: "#161620"
+  surface-border: "#2a2a3a"
+  muted: "#6b6b80"
+typography:
+  headline:
+    fontFamily: Space Grotesk
+    fontSize: 5rem
+    fontWeight: 700
+    letterSpacing: -0.03em
+  body:
+    fontFamily: JetBrains Mono
+    fontSize: 1.5rem
+    fontWeight: 400
+  label:
+    fontFamily: JetBrains Mono
+    fontSize: 0.875rem
+    fontWeight: 500
+    textTransform: uppercase
+    letterSpacing: 0.08em
+rounded:
+  none: 0px
+  sm: 4px
+  md: 8px
+spacing:
+  sm: 8px
+  md: 16px
+  lg: 40px
+motion:
+  energy: high
+  easing:
+    entry: "expo.out"
+    exit: "power3.in"
+    ambient: "sine.inOut"
+  duration:
+    entrance: 0.4
+    hold: 1.8
+    transition: 0.4
+  atmosphere:
+    - terminal-cursor
+    - scan-lines
+    - grid-dots
+  transition: glitch
+---
+
+## Overview
+
+getraw is a fast media downloader CLI built in Bun/TypeScript — a yt-dlp replacement with native JS execution. The visual identity is terminal-native: dark background, green accent (terminal green), monospace type for code, and sharp geometric motion. Feels like watching a hacker tool come alive.
+
+## Colors
+
+- **Primary (#0c0c0f):** Near-black background with slight blue undertone
+- **On-primary (#e8e8ec):** Off-white text, not pure white
+- **Accent (#00ff88):** Terminal green — the signature color. Used for highlights, commands, active states
+- **Surface (#161620):** Slightly elevated panels, code blocks
+- **Muted (#6b6b80):** Comments, secondary info
+
+## Typography
+
+- **Headlines:** Space Grotesk 700 — geometric, techy, not generic
+- **Code/Body:** JetBrains Mono 400 — the developer's monospace
+- **Labels:** JetBrains Mono 500 uppercase — structural metadata
+
+## Do's and Don'ts
+
+### Do
+- Use terminal-style animations (typing effect, cursor blink, line-by-line reveal)
+- Show real CLI commands and output
+- Use the green accent sparingly but boldly
+- Let the dark background breathe
+
+### Don't
+- Use gradients on text
+- Use rounded corners larger than 8px
+- Use decorative serif fonts
+- Use bright colors other than the accent green