Skip to content

Commit 5f66af8

Browse files
committed
docs: ground philosophy and add antinote origin story
1 parent fdaddb5 commit 5f66af8

2 files changed

Lines changed: 18 additions & 44 deletions

File tree

PHILOSOPHY.md

Lines changed: 17 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,68 +1,44 @@
11
# Our Philosophy
22

33
### 1. **Your Thoughts Are Ephemeral**
4-
A scratchpad shouldn't feel like a database. PaperCache is designed for the temporary, the messy, and the in-between. It spawns when you need it, vanishes when you're done, and respects the fleeting nature of brainstorming. We believe in tools that feel like an extension of your mind, not a filing cabinet.
4+
A scratchpad shouldn't feel like a database. PaperCache is designed for the temporary, the messy, and the in-between. It spawns when you need it, vanishes when you're done, and gets out of your way.
55

66
### 2. **Active > Passive**
7-
Most note-taking apps are passive: you write text, and it sits there. PaperCache is **active**. It evaluates your math in real-time, queries AI inline, links your notes automatically, and visualizes your knowledge graph. We believe your notes should *work for you*, not just store your words.
7+
PaperCache is active. It evaluates your math in real-time, queries AI inline, links your notes automatically, and visualizes your knowledge graph. Your notes should work for you, not just store your words.
88

9-
### 3. **Zero Friction is Non-Negotiable**
9+
### 3. **Zero Friction**
1010
If a tool slows you down, you won't use it. That's why PaperCache:
1111
- Spawns exactly where your mouse cursor is
12-
- Uses **0% CPU when idle** (truly zero, not "low")
12+
- Uses 0% CPU when idle
1313
- Hides markdown syntax when you aren't editing
1414
- Vanishes the moment you click away
15-
- Loads heavy dependencies (like `mathjs`) only when needed
1615

17-
We believe performance is a feature, not an optimization.
18-
19-
### 4. **Developers Think Differently**
20-
You don't just write prose; you write code, equations, and structured data. PaperCache is built for the developer brain:
16+
### 4. **Built for Developers**
17+
You don't just write prose; you write code, equations, and structured data. PaperCache includes features like:
2118
- Reactive variables (`/var x = 5`)
2219
- Inline AI with context injection (`/ctx`)
2320
- Implicit folder organization (`projects/PaperCache.md`)
2421
- Knowledge graph visualization
2522

26-
We believe productivity tools should match how you *actually* think, not how a product manager thinks you should think.
27-
28-
### 5. **Open Source is the Only Ethical Choice**
29-
Your personal workflow shouldn't be locked behind a paywall or a SaaS subscription. PaperCache is:
23+
### 5. **Free and Open Source**
24+
I saw a really cool app called Antinote, but it was locked behind a paywall. I wanted something just as good that was open source and could fit my own specific needs, so I built PaperCache to match it. It solved my problem perfectly, and since other people probably have the exact same needs, I made it completely free and open for everyone to use, fork, and improve.
3025
- **100% free** (no "Pro" tier, no feature gating)
3126
- **Open source** (audit the code, contribute, fork it)
32-
- **Self-hosted** (your data never leaves your machine)
33-
- **Cross-platform** (macOS, Windows, Linux)
27+
- **Local first** (your data never leaves your machine)
3428

35-
We believe transparency and accessibility aren't features; they're responsibilities.
36-
37-
### 6. **AI Should Be Invisible, Not Intrusive**
38-
Most apps bolt on a chatbot sidebar and call it "AI-powered." PaperCache integrates AI **inline**, where you're already working:
29+
### 6. **Invisible AI**
30+
PaperCache integrates AI inline, where you're already working:
3931
- Type `/ai <prompt>` and get an answer right in your document
4032
- Use `/ctx <prompt>` to automatically include your entire note as context
41-
- Your API keys are encrypted with Electron's `safeStorage`
42-
43-
We believe AI should augment your workflow, not interrupt it.
33+
- Your API keys are encrypted securely locally.
4434

45-
### 7. **Opinionated Design is Kind**
46-
We don't try to be everything to everyone. PaperCache makes specific, intentional choices:
47-
- No complex plugin system (we ship what works)
35+
### 7. **Opinionated Design**
36+
PaperCache makes specific, intentional choices:
37+
- No complex plugin system
4838
- No cloud sync (your data is yours)
49-
- No WYSIWYG editor (you get raw text speed with rendered readability)
50-
51-
We believe saying "no" to feature creep is how you build tools that respect your users' time.
52-
53-
### 8. **Engineering Rigor Matters, Even for "Simple" Apps**
54-
PaperCache is version `0.2.10`, but it has:
55-
- CI/CD pipelines with automated testing
56-
- Zustand state management with slice-subscriptions
57-
- Lazy-loaded heavy dependencies
58-
- Debounced reactive evaluations
59-
- Power throttling via `powerMonitor` API
60-
61-
We believe "just a scratchpad" is no excuse for sloppy code. Every line is written with the same rigor as a production SaaS app.
39+
- No WYSIWYG editor (raw text speed with rendered readability)
6240

6341
---
6442

6543
### The Bottom Line
66-
**PaperCache exists because we refuse to compromise.** We refuse to accept that Electron apps must be bloated. We refuse to accept that scratchpads must be dumb. We refuse to accept that productivity tools must be expensive or closed-source.
67-
68-
This is a tool built by a developer, for developers, with an obsession for performance, privacy, and polish. It's the scratchpad we always wanted but could never find—so we built it ourselves.
44+
PaperCache is a simple, polished tool built by a developer to solve a personal need. It's the floating scratchpad I always wanted but didn't want to pay a subscription for—so I built it myself, and now it's yours too.

README.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,7 @@
55
**A floating markdown scratchpad for developers and power users.**
66
</div>
77

8-
> **PaperCache exists because we refuse to compromise.** We refuse to accept that Electron apps must be bloated. We refuse to accept that scratchpads must be dumb. We refuse to accept that productivity tools must be expensive or closed-source.
9-
>
10-
> This is a tool built by a developer, for developers, with an obsession for performance, privacy, and polish. It's the scratchpad we always wanted but could never find—so we built it ourselves. Read our [Core Philosophy](PHILOSOPHY.md).
8+
> **Why PaperCache?** I saw a cool tool called Antinote, but it was locked behind a paywall. I wanted something similar that was open source and fit my own workflow perfectly, so I built PaperCache to match it. It solved my problem, and I figured other people might have the exact same needs, so I made it completely free and open for everyone. Read the full story in our [Core Philosophy](PHILOSOPHY.md).
119
1210
Summon it with a hotkey. Jot. Dismiss. It stays out of your way until you need it.
1311

0 commit comments

Comments
 (0)