MCPcopy
hub / github.com/UdaraJay/Pile

github.com/UdaraJay/Pile @v0.9.9 sqlite

repository ↗ · DeepWiki ↗ · release v0.9.9 ↗
347 symbols 799 edges 146 files 0 documented · 0%
README

Pile

Pile is a desktop app for reflective journaling. It's about simplicity, keeping your data local, and enhancing your journaling experience with AI.

Pile app screenshot

Getting started

  1. Download the latest version of Pile by going to the Pile releases page.
  2. On macOS Open the .zip or .dmg file and drag the application to the destination of your choice (optional), such as your Applications/ folder. On Windows, use the .exe to install.
  3. Finally open the application, create a New Pile, and start your reflective journey.

AI reflections (requires GPT-4)

Enhance your journaling experience by integrating OpenAI's GPT AI reflections into Pile. If you have access to OpenAI's GPT-4 API, you can use your API key to:

  • Reflect on entries: Click "reflect" on any written entry to get AI-generated insights and thoughts as a reply in the thread.
  • Search or ask questions: Click the "reflect" icon on the top-right of the window to search or ask question about your entire journal.

How to setup AI features: head over to platform.openai.com/api-keys and create a new API key. Click the settings icon on the top-right corner of Pile and enter your secret API key into the API key field.

Before you use the AI-powered features within this app, we strongly recommend that you configure a spending limit within OpenAI's interface to prevent unexpected costs.

Contributing

If you'd like to contribute to Pile, feel free to fork the repository, make your changes, and submit a pull request. Contributions are welcomed and appreciated, however this is an experimental project, so any changes and new features are merged into this distribution of Pile at my discretion.

For a detailed guide on contributing, read the CONTRIBUTING.md file.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Special thanks

Many thanks and appreciation to all these people and projects for their contributions to Pile.

Extension points exported contracts — how you extend this code

Window (Interface)
(no doc)
src/renderer/preload.d.ts
DarwinMenuItemConstructorOptions (Interface)
(no doc)
src/main/menu.ts

Core symbols most depended-on inside this repo

usePilesContext
called by 21
src/renderer/context/PilesContext.js
getCurrentPilePath
called by 17
src/renderer/context/PilesContext.js
get
called by 14
src/main/utils/pileTags.js
set
called by 12
src/main/utils/pileLinks.js
useIndexContext
called by 8
src/renderer/context/IndexContext.js
addNotification
called by 7
src/renderer/context/ToastsContext.js
save
called by 7
src/main/utils/pileIndex.js
load
called by 7
src/main/utils/pileTags.js

Shape

Function 257
Method 68
Class 20
Interface 2

Languages

TypeScript100%

Modules by API surface

src/main/utils/pileIndex.js16 symbols
src/renderer/pages/Pile/Editor/index.jsx12 symbols
src/main/utils/pileEmbeddings.js12 symbols
src/main/utils/pileTags.js10 symbols
src/main/utils/pileHighlights.js10 symbols
src/main/menu.ts10 symbols
src/renderer/pages/Pile/Editor/LinkPreviews/LinkPreview/index.jsx9 symbols
src/renderer/context/PilesContext.js9 symbols
src/main/utils/pileHelper.js9 symbols
src/renderer/utils/fileOperations.js8 symbols
src/renderer/pages/Pile/Settings/index.jsx8 symbols
src/main/utils/pileLinks.js8 symbols

Dependencies from manifests, versioned

@adobe/css-tools4.3.2 · 1×
@babel/traverse7.23.2 · 1×
@electron/notarize1.2.3 · 1×
@electron/rebuild3.2.13 · 1×
@radix-ui/react-alert-dialog1.0.4 · 1×
@radix-ui/react-dialog1.0.4 · 1×
@radix-ui/react-dropdown-menu2.0.5 · 1×
@radix-ui/react-switch1.0.3 · 1×
@svgr/webpack8.0.1 · 1×
@tanstack/react-virtual3.0.1 · 1×

For agents

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

⬇ download graph artifact