skim

멀티 플랫폼 정보 큐레이션 파이프라인 모노레포다. Python crawler/CLI, React/Tauri desktop app, Rust backend를 한 저장소에서 관리한다.

현재 배포 버전은 v0.2.0이다.

Workspace Layout

.
├── apps/
│   └── desktop/                # React + Vite + Tauri desktop app
├── packages/
│   ├── skim-cli/               # Typer CLI package
│   └── skim-core/              # crawler, DB, enrichment, feed config
├── tooling/
│   └── scripts/                # 운영/보조 스크립트
├── data/                       # local runtime artifacts
└── docs/

Install

pnpm install
uv sync
uv run playwright install
cp .env.example .env

Desktop Release

macOS용 desktop 앱은 GitHub Releases에서 DMG로 배포한다.

• 태그: v0.2.0
• 대상 아티팩트: Skim Desktop_<version>_aarch64.dmg
• 설치 흐름: DMG 다운로드 -> 앱을 Applications로 복사 -> 첫 실행

Common Commands

Root

pnpm lint
pnpm test
pnpm build
pnpm desktop:dev

CLI

uv run skim platforms
uv run skim crawl all --days 1
uv run skim crawl hackernews --count 10
uv run skim crawl reddit --subreddit python --sort hot --count 10
uv run skim login threads

Desktop

pnpm desktop:dev
pnpm desktop:build

pnpm desktop:build는 Tauri bundle을 생성하며, macOS DMG는 기본적으로 target/release/bundle/dmg/ 아래에 만들어진다.

Supported Platforms

유형	플랫폼	소스
Feed	HackerNews	hnrss.org
Feed	GeekNews	news.hada.io Atom
Feed	YouTube	RSS + yt-dlp
Feed	ProductHunt	RSS
Feed	arXiv	Atom API
Feed	HuggingFace	Daily Papers JSON API
Feed	Every.to	Multi-feed RSS
API	Threads	Instagram Private API
API	X	GraphQL (twitter-api-client)
API	LinkedIn	Voyager GraphQL
API	Reddit	JSON listing API

Architecture

uv run skim ...
  -> packages/skim-cli/src/skim_cli/cli.py
  -> packages/skim-core/src/skim_core/crawlers/*
  -> packages/skim-core/src/skim_core/db.py
  -> data/skim.db + data/<platform>/*.json

pnpm desktop:dev
  -> apps/desktop
  -> apps/desktop/src-tauri/src/lib.rs
  -> data/skim.db + data/sessions/*.json

Data

• SQLite: data/skim.db
• Sessions: data/sessions/*.json
• Crawl output: data/<platform>/*.json

Desktop Features

• tracked source management
• credential management with macOS Keychain integration
• session status inspection and login trigger
• post search/filter/detail view
• CSV / JSON / Markdown export
• YouTube source import from skim_core.feed_config

Environment Variables

SKIM_WORKSPACE_ROOT=
GOOGLE_WEBAPP_URL=

THREADS_USERNAME=
THREADS_PASSWORD=
LINKEDIN_USERNAME=
LINKEDIN_PASSWORD=
X_USERNAME=
X_PASSWORD=
REDDIT_USERNAME=
REDDIT_PASSWORD=

Automation

0 9 * * * /path/to/skim/tooling/scripts/run_daily_feed.sh

Quality Gates

• JS/TS workspace tasks: pnpm + turbo
• Python workspace tasks: uv
• Git hooks: husky
• Commit message validation: commitlint

Release Flow

pnpm desktop:build
git tag v0.2.0
gh release create v0.2.0 target/release/bundle/dmg/*.dmg

릴리즈 전에 최소한 아래 검증을 통과시키는 것을 기준으로 한다.

• pnpm lint
• pnpm test
• pnpm build
• pnpm typecheck

License

MIT