MCPcopy Index your code
hub / github.com/cablehead/stacks

github.com/cablehead/stacks @v0.15.13

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.15.13 ↗ · + Follow
294 symbols 818 edges 52 files 1 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Stacks CI Discord

Stacks is a clipboard manager.

screenshot

About

With so many great clipboard managers already available, why create another one?

I think of my clipboard as "picking things up" to move them around or redirect them. In this sense, your system's clipboard acts as a strong proxy for your "locus of attention" when you're using a computer.

A clipboard manager, then, is a tool to capture and work with your "locus of attention." It ambiently captures your current tasks and work context.

Stacks is an experimental tool for tracking and manipulating your current context using pipes and filters. But that’s a lot to explain, so I usually just describe it as a clipboard manager.

A humble clipboard manager aspiring to elevate the depth of our conversations— no less.

UX disclaimer

A quick note on the user experience (UX): it’s fair to say it’s still a bit rough around the edges. If Stacks reaches a UX level similar to (neo)vim, I'd consider that a success. It’s pretty spartan and utilitarian, so being comfortable with the command line, or feeling adventurous, definitely helps.

Stacks is my personal "tool for thought" that I use as my daily driver. Eventually, I’d like Stacks to reach the polish of tools like Obsidian, but for now, the focus is on its experimental nature and the underlying event-sourcing store.

Give it a try!

If you're into experimental tools and are okay with a minimalist, utilitarian design, give Stacks a try-- I'd love to hear your thoughts!

Download

.DMG installers that have been notarized by Apple.

  • Current version: v0.15.12
  • Last release: Oct 23, 2024

MacOS (Universal)

Community

  • We have a Discord channel where we chat about clipboard managers, flashcards, neo-browsers, Tauri, Rust, wasm, tools of thought, and generally fun geekery, and
  • We're using Github Discussions as a forum.

Usage

To launch Stacks⌃ + Space
Accessibility
Increase font size⌘ + +
Decrease font size⌘ + -
Navigation
Navigate down or ⌃ + n
Navigate up or ⌃ + p
Navigate left or ⌃ + h
Navigate right or ⌃ + l
Navigate to the stack below⌥ + ↓
Navigate to the stack above⌥ + ↑
Reset nav (clears filter and brings focus to the top)⌘ + 0
Item Manipulation
Move an item down⌘ + ↓
Move an item up⌘ + ↑
Bring current item and stack to the top⌘ + t
Global shortcuts
New note⌘ ⇧ + n

Development

git clone https://github.com/cablehead/stacks.git
cd stacks
npm install
npm run tauri dev

Built with:

Rust, Tauri, sled, cacache, Tantivy, Tokio, hyper, Comrak, syntect, TypeScript, Preact, scru128, tracing,

🙏💚

Extension points exported contracts — how you extend this code

ImportMeta (Interface)
(no doc)
src/vite-env.d.ts
MatchKeyOptions (Interface)
(no doc)
src/utils.ts
Content (Interface)
(no doc)
src/types.ts
ExecStatus (Interface)
(no doc)
src/modals/pipeToCommand.tsx
MetaValue (Interface)
(no doc)
src/panels/meta.tsx
Cacheable (Interface)
(no doc)
src/types.ts
ExecStatus (Interface)
(no doc)
src/modals/pipeStackToShell.tsx
Item (Interface)
(no doc)
src/types.ts

Core symbols most depended-on inside this repo

merge
called by 42
src-tauri/src/view.rs
matchKeyEvent
called by 39
src/utils.ts
add
called by 20
src-tauri/src/store.rs
select
called by 19
src-tauri/src/ui.rs
add_stack
called by 19
src-tauri/src/store.rs
join
called by 14
src/utils.ts
insert_packet
called by 14
src-tauri/src/store.rs
scan
called by 14
src-tauri/src/store.rs

Shape

Function 168
Method 82
Class 23
Interface 15
Enum 6

Languages

Rust62%
TypeScript38%

Modules by API surface

src-tauri/src/commands.rs44 symbols
src-tauri/src/store.rs43 symbols
src/types.ts37 symbols
src/ui/icons.tsx22 symbols
src-tauri/src/ui.rs21 symbols
src-tauri/src/view.rs16 symbols
src-tauri/src/http.rs9 symbols
src-tauri/src/spotlight.rs8 symbols
src/utils.ts7 symbols
src-tauri/src/state.rs7 symbols
src/panels/statusbar.tsx6 symbols
src/modals/index.tsx6 symbols

For agents

$ claude mcp add stacks \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page