Skip to main content

ThisDamnThing

First I called it Dryft, but that was taken.
Then I tried Ryft. Taken.
Seska? Ugh.
Ardra? Dammit!.
Laya? Of course that's taken.
And on and on and on..
Eventually I said "screw it!".
So just use ThisDamnThing.

ThisDamnThing

A local workspace for Claude Code and Codex, with a knowledge brain that grows with your work and stacks that extend what your agents can do.

Make your workspace your own

Feature What you can do
Build your brain Keep useful facts and decisions as linked Markdown notes. Choose what to remember through review.
Find answers with sources Ask your brain questions and get references to approved knowledge.
Give your agents rules Set working preferences and boundaries with a workspace Constitution.
Use ThisDamnThing's UI Say “use ui” to answer questions and work through choices in a local browser.
Bring your projects Link existing project folders and get oriented without moving their source.
Extend with Stacks Add skills, workflows and capabilities when you need them.

Install and create a workspace

You need Python 3.11+ and pipx. Install Claude Code or Codex separately if you want an agent integration.

The commands below describe the planned public installation. PyPI publication and installation from the public registry are still awaiting release verification.

Ask your agent:

Install and set up ThisDamnThing via pipx, create a workspace at [my chosen directory], and check it.

Replace the bracketed directory with your preferred location. Setup has no ThisDamnThing skill before installation. Open the created workspace in your agent, review its workspace and hook trust prompts, and use /tdt-workspace in Claude or $tdt-workspace in Codex, or select it from the skill picker.

For terminal setup, run these examples from a parent directory outside your projects and the ThisDamnThing source checkout. Paths are relative to that directory.

pipx install thisdamnthing
tdt init "./my workspace"
tdt --workspace "./my workspace" doctor

You can also cd into your chosen folder and run tdt init without a path to initialize the current directory, then run tdt doctor.

Choose a workspace folder outside your existing projects. If pipx asks you to update PATH, follow its instructions and reopen your shell. ThisDamnThing starts with zero stacks and detects Claude and Codex on PATH. Add --agent claude, --agent codex, --agent both or --agent none to init to choose explicitly. Existing unrelated files are preserved; conflicting files are refused.

Read the usage guides, or open the local guides in your workspace's docs/ folder.


Developing ThisDamnThing

Working on ThisDamnThing itself? Start with the developer documentation for setup, architecture and development practices. Open this source checkout in your agent and say “onboard me” for guided development setup.

Development setup · Architecture · Making a change

Licensed under Apache-2.0.


If you find any bugs, it's because I left them there, so I have something to do later.

Metadata

Release files for thisdamnthing 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for thisdamnthing 0.1.3
File Size Uploaded
thisdamnthing-0.1.3.tar.gz 135.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for thisdamnthing 0.1.3
File Interpreter ABI Platform
thisdamnthing-0.1.3-py3-none-any.whl Python 3 none any Details

Total release size: 299.9 kB

Release files / thisdamnthing-0.1.3.tar.gz

Download URL thisdamnthing-0.1.3.tar.gz
Size 135.5 kB
Tags Source
SHA-256 checksum
How to use checksums
629d3f76177f60bc8c0aaa6ef07e59d023951ef240305e4269e1fa82f047db0a
BLAKE2b-256 checksum
How to use checksums
72055f6928b6b4460c704c5498f434f89a95857795bcb7afa83afa17d6671726
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.

Transparency log

Release files / thisdamnthing-0.1.3-py3-none-any.whl

Download URL thisdamnthing-0.1.3-py3-none-any.whl
Size 164.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8383647898269e0c40742c21750817e34a31308fc0bab29c3d5c0481c0820c55
BLAKE2b-256 checksum
How to use checksums
a7fc1fe02367fb8bdaadf3923c126fdb08cd5784ba85d7c194615514c8a82a3b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

This release

0.1.3 This release

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

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