sweaConnector

A tool that connects your personal algorithm study repository to Claude and bakes it into a read-only Android viewer.

Claude reads and writes directly to your study repository — picking the next problem for you to solve, adjusting the schedule, and recording solution notes. The result is an ebook-style app tuned for foldables that you can pull out anytime.

   ┌──────────────┐   MCP    ┌──────────────┐  빌드 시 주입  ┌──────────────┐
   │  당신의 학습   │ ───────► │    Claude    │              │  안드로이드    │
   │  저장소        │ ◄─────── │              │              │  뷰어 (APK)   │
   │  (private)    │  기록     └──────────────┘              └──────────────┘
   └──────────────┘                                                ▲
          └─────────────────────────────────────────────────────────┘

What this repository does not contain

Neither problem statements, problem numbers, nor solution code are here. All of it lives only in your private repository.

Many algorithm study platforms prohibit publishing or sharing problems and solutions in their terms of service. That's why sweaConnector is intentionally an empty vessel — it only contains tools, conventions, and general CS concept explanations, while the content is injected from your repository at build time. All the sample problems in fixtures/ are fictional.

Structure

Getting Started

git clone https://github.com/rleaderjoon/sweaConnector
cd sweaConnector
npm install
npm test                              # 13개 자체 검증 (MCP 핸드셰이크 포함)

# 1. 내 저장소가 규약에 맞는지 확인
node pipeline/extract.mjs --repo /path/to/my-study-repo --out content.json

# 2. 일정 설정 — 내 학습 저장소 루트에 .sweaconnector.json
echo '{"startDate":"2026-08-15","examDate":"2026-09-19"}' > /path/to/my-study-repo/.sweaconnector.json

# 3. Claude 에 붙이기
claude mcp add swea -- node ./mcp/index.mjs --repo /path/to/my-study-repo

# 4. 내 APK 굽기 — 콘텐츠 추출부터 서명까지 한 번에
bash pipeline/build-apk.sh /path/to/my-study-repo release

The APK is output to app/reader/build/outputs/apk/release/. To hand it to GitHub Actions, manually run .github/workflows/apk.yml (since this is a public repository, it builds with demo content).

Installing on a phone

1. Upload the APK to a Release in your private repository — gh release create v0.1.0 <apk> -R <owner>/<repo>

2. Open that Release in your phone's browser and download the APK (you must be logged in to GitHub)

3. Allow the browser to install apps from "unknown sources" once

Don't upload your APK to a public repository — the APK contains problems and solutions.

Screens

Folding and unfolding preserves your reading position (the activity is not recreated thanks to configChanges).

MCP Tools

schedule_status is not a tool that reads the plan to you; it is a tool that assumes the plan is already off track and fixes it. Look at slackDays first — it is the number of spare days left until the exam date, and if it is negative, you need to pick up the pace.

Requirements

• Node 20+

• JDK 17+ · Android SDK (platform 35) — only when building locally. Not needed if building with Actions.

Design Principles

• Read-only viewer. The app does not edit. Writes go to the repository through Claude (MCP).

• No runtime network. Content is baked into the APK at build time. There is nothing to parse when tapped, so it opens instantly.

• Foldable-first. Folded, it's one page; unfolded, it's a spread. Both portrait and landscape.

• Diagrams are vector. Algorithm diagrams are hand-drawn SVG → VectorDrawable. AI-generated images are plausibly wrong.

License

MIT (for tools and concept explanations only). You are responsible for complying with the rights and terms of the content you inject.