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.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 thisdamnthing 0.1.2
File Size Uploaded
thisdamnthing-0.1.2.tar.gz 132.4 kB Details

Built distribution (wheel)

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

Total release size: 293.2 kB

Release files / thisdamnthing-0.1.2.tar.gz

Download URL thisdamnthing-0.1.2.tar.gz
Size 132.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f12afed1a2ad5a5c43d4435f9c04e9d17e4696b19213aad9e1f10f08f90bcd50
BLAKE2b-256 checksum
How to use checksums
30eb38a8ded0c8d76f1ff8cb557dd58fc28be571f353143dd3ad61c4c099ad75
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 22, 2026.

Transparency log

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

Download URL thisdamnthing-0.1.2-py3-none-any.whl
Size 160.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
db854492bba5f1b4bb65cb33b80dffc54d793ded9ffdfa5848f353e93907cf64
BLAKE2b-256 checksum
How to use checksums
02534a85405349ac26e972d64bb4f217d9871b46ade1a608cfb1e455a23a7be8
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 22, 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

0.1.3

2 release files

This release

0.1.2 This release

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