ginfo-cli

ginfo-cli is an extensible CLI for collecting information from external sources. The current 0.1 release focuses on fetching YouTube transcripts and saving task artifacts locally.

Install

npm install -g ginfo-cli

What It Does

• Fetches YouTube video transcripts from a URL or videoId
• Writes task artifacts to local task/NN-* directories
• Supports explicit proxy configuration for environments that cannot reach YouTube directly

Usage

ginfo youtube transcript "https://www.youtube.com/watch?v=3hQ4eF4OJVQ"

With explicit proxy:

ginfo youtube transcript "https://www.youtube.com/watch?v=3hQ4eF4OJVQ" --proxy http://127.0.0.1:7897

With structured output:

ginfo youtube transcript "https://www.youtube.com/watch?v=3hQ4eF4OJVQ" --json

With a custom task directory suffix:

ginfo youtube transcript "https://www.youtube.com/watch?v=r2PW4oGbbRY" --task-name second-youtube-transcript

Output

Each run creates a local task directory such as task/07-second-youtube-transcript/ with:

• meta.json
• task.md
• transcript.json
• transcript.txt

Proxy Resolution Order

The CLI resolves proxy settings in this order:

1. --proxy <url>
2. ginfo.config.json
3. .ginfo/config.json
4. HTTPS_PROXY / HTTP_PROXY / ALL_PROXY
5. macOS system proxy

Development

npm install
npm run build
npm run dev -- --help

Local development example:

npm run dev -- youtube transcript "https://www.youtube.com/watch?v=3hQ4eF4OJVQ" --proxy http://127.0.0.1:7897

Config File

Project config example:

mkdir -p .ginfo
cp ginfo.config.example.json .ginfo/config.json

{
  "proxy": "http://127.0.0.1:7897"
}

Current Scope

The current package is intentionally narrow:

• Implemented: youtube transcript
• Not yet implemented: youtube meta, X/Twitter, Telegram, generic plugin loading