Skip to main content

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)

Source distribution for ideadump 0.0.2
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)

Table of built distributions (wheels) for ideadump 0.0.2
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page