Skip to content

Repository files navigation

Kisuke

Local-first context reconstruction system.


Core Promise

Kisuke does not return notes.

Kisuke returns working context.


What is Kisuke?

Kisuke helps you resume work with minimal cognitive effort.

Instead of searching through notes, browser tabs, repositories, documentation, chats, and files, Kisuke reconstructs the exact context required to continue meaningful work.

It is built for developers, builders, researchers, and anyone who frequently switches between projects.


Philosophy

  • Local-first
  • Markdown-first
  • Git-native
  • Offline-first
  • Resume before search
  • Reference over duplication
  • Single ownership
  • Integrate before rebuilding
  • AI is optional
  • Documentation-first development

What Kisuke Is

  • Context reconstruction engine
  • Personal knowledge operating system
  • Project resume engine
  • Decision memory
  • Developer workflow companion

What Kisuke Is Not

  • Note-taking application
  • Project management tool
  • Cloud service
  • AI agent
  • Git replacement
  • Obsidian replacement

Repository

.
├── docs/
├── architecture/
├── adrs/
├── rfcs/
├── scripts/
├── templates/
├── examples/
├── src/
├── tests/
└── website/

Documentation

The canonical specification lives in docs/. See docs/MASTER_SPECIFICATION.md for the navigation index.


Development Workflow

Architecture

↓

Documentation

↓

Implementation

↓

Testing

↓

Review

↓

Release

Milestones

The canonical milestone order is defined once, in docs/execution/13-roadmap.md. It is not restated here to avoid drift.


Principles

  • One owner per entity.
  • Markdown is the source of truth.
  • Git owns history.
  • AI owns no data.
  • Plugins never modify the core directly.
  • Every implementation follows the specification.

Current Status

  • Architecture: Frozen
  • Documentation: Complete
  • Implementation: v0.1.0 (309 tests passing)

License

See LICENSE.

About

Kisuke

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages