mirror of https://github.com/doum1004/llmwiki-cli.git synced 2026-05-18 16:57:13 +02:00

Files

doum1004 6a8b9a5612 Phase 1: Bootstrap + Init + Registry

Implement llmwiki-cli v0.1.0 — a CLI tool for LLM agents to build and
maintain personal knowledge bases via pure filesystem + git operations.

Phase 1 includes:
- wiki init: create wiki with directory structure, SCHEMA.md, git init
- wiki registry: list all registered wikis
- wiki use: switch active wiki
- Global registry at ~/.config/llmwiki/
- Wiki resolution chain (--wiki flag > cwd > walk up > default)
- 23 tests passing
- Published to npm as llmwiki-cli

2026-04-10 01:36:17 -04:00

1.7 KiB

Raw Permalink Blame History

Phase 5: GitHub Auth + Repo Management

Status: NOT STARTED

Goal: User can authenticate with GitHub, create/clone repos, push/pull wikis.

Files

File	Status	Description
`src/lib/auth.ts`	Pending	GitHub OAuth device flow, token storage at ~/.config/llmwiki/auth.yaml
`src/lib/github.ts`	Pending	GitHub API: listRepos, createRepo, deleteRepo
`src/commands/auth.ts`	Pending	`wiki auth login/status/logout`
`src/commands/repo.ts`	Pending	`wiki repo list/create/clone/connect`
`src/commands/push.ts`	Pending	`wiki push [--wiki <name>]`
`src/commands/pull.ts`	Pending	`wiki pull [--wiki <name>]`
`src/commands/sync.ts`	Pending	`wiki sync [--wiki <name>]` — pull + push

Commands to Add

wiki auth login
wiki auth status
wiki auth logout
wiki repo list [--all] [--filter]
wiki repo create <name> [--domain] [--public]
wiki repo clone [name] [--all] [--filter]
wiki repo connect [wiki-id]
wiki push [--wiki <name>]
wiki pull [--wiki <name>]
wiki sync [--wiki <name>]

Key Design Decisions

GitHub OAuth device flow (no client secret needed, public client_id)
Token stored at ~/.config/llmwiki/auth.yaml
Git credential helper at ~/.config/llmwiki/git-credential-helper.sh
repo create creates private repo named wiki-<name> by default
repo clone auto-detects .llmwiki.yaml; scaffolds if missing
All GitHub API calls use fetch() with Bearer token

Prerequisites

Requires a registered GitHub OAuth App (client_id)
Network access (this is the only phase that makes network calls)

Entry Points to Update

bin/wiki.ts — register new commands, add auth commands to SKIP_RESOLUTION

1.7 KiB Raw Permalink Blame History