ideadump
A place to dump ideas: capture them in your own words, research them a little, index and relate them, and find them again.
pip install ideadump
You tell an agent an idea in passing; it runs one command to keep it, verbatim, and a light research pass to see what it is called, what already exists and whether it is promising. Later you ask what ideas you have about something, or whether anything you have been working on relates to them.
ideadump add "a place to dump ideas, and do a bit of research on them" --title "Idea dump" --tags "tools, notes" --source my-session
ideadump note idea-dump --file light-research.md --depth light # attach research notes
ideadump find "note taking research" # ranked, with the shared words
ideadump find --file recent-work.md # which ideas relate to this page of recent work?
ideadump ls --status promising
ideadump show idea-dump
Research is done by the agent with whatever search tools it has, so it sends queries (generic terms, not your notes) to outside services; the ideas themselves stay in your store.
The primary user is an agent: the package ships a skill, ideadump, that tells it when and how to use these verbs (capture, light and deep research, linking, the "is my recent work related to my ideas" pass). See Agent skill.
Where ideas live
Ideas are kept in a dol store, a MutableMapping of path to text. By default it is a local folder, ~/.local/share/ideadump (or $IDEADUMP_DATA_DIR). Each idea is a folder:
README.md # the index: newest first, then by tag (generated)
ideas/2026-11-14-idea-dump/
idea.json # the record: words (verbatim), title, summary, tags, status, research, links
README.md # the idea's page (generated)
research/2026-11-14-light.md # research notes, never overwritten
The pages are generated from the records on every write, so the folder reads well in a file browser or on GitHub.
Syncing to a private git repository
pip install 'ideadump[git]'
ideadump sync-init you/my-ideas # creates the repository PRIVATE if missing, and makes the data folder its checkout
ideadump sync # pull, commit everything, push
ideadump sync-status
The git work is acquaint's guarded sync: it refuses a repository that is not private, and a pre-push hook re-checks the remote and its visibility on every push. sync-init adopts an existing ideas folder (and refuses one that is a checkout of another repository); on a second machine, clone the repository into the data folder first. Generated pages are marked in .gitattributes so they never conflict: sync rebuilds them from the merged records after each rebase. A private repository is access control, not encryption.
Python
Every verb is a plain function returning a JSON-able dict, and takes the store as files, so any MutableMapping works (a dict in tests, another dol store elsewhere):
from ideadump import add, find, note
files = {}
r = add("offline speech to text on the phone", tags="audio", files=files)
note(r["id"], text="# Prior art\n\nWhisper.cpp, Vosk.", files=files)
find("speech recognition", files=files)["hits"]
find ranks with BM25 (standard library); pass score= to plug in another scorer, such as a semantic one.
Agent skill
The skill lives in the package at ideadump/data/skills/ideadump/SKILL.md. For Claude Code, with the package installed, link it into your skills folder:
ln -s "$(python -c 'import ideadump, pathlib; print(pathlib.Path(ideadump.__file__).parent / "data/skills/ideadump")')" ~/.claude/skills/ideadump
Then tell any session "idea for later: ..." and it captures it. Other agent hosts read the same file; point yours at that folder (with the gh skill extension, gh skill install thorwhalen/ideadump ideadump).
Metadata
Release files for ideadump 0.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ideadump-0.0.2.tar.gz | 22.9 kB | Without provenance | Details for ideadump-0.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ideadump-0.0.2-py3-none-any.whl | Python 3 | none | any | Details for ideadump-0.0.2-py3-none-any.whl |
Total release size: 47.6 kB
Release files / ideadump-0.0.2.tar.gz
| Download URL | ideadump-0.0.2.tar.gz |
|---|---|
| Size | 22.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e3b3216d7b0d9a9f6b7728351e70ad6f741da706f60991cede3a712826470de6
|
|
BLAKE2b-256 checksum How to use checksums |
703e02c3f5e7ade78f2ff75a7ceda29438853bf82f94d82442a6880774d24e5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / ideadump-0.0.2-py3-none-any.whl
| Download URL | ideadump-0.0.2-py3-none-any.whl |
|---|---|
| Size | 24.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8498cf8eee0fc0d464fa90f066175fa9559dff130185471c34cc6a780b48e2ee
|
|
BLAKE2b-256 checksum How to use checksums |
9a576eb4461ac25f7d213f7b91ed827e9f4c77f1a19d2627abade9b24a9b83a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for ideadump 0.0.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.