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.10

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.10
File Size Uploaded
thisdamnthing-0.1.10.tar.gz 163.2 kB Details

Built distribution (wheel)

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

Total release size: 362.9 kB

Release files / thisdamnthing-0.1.10.tar.gz

Download URL thisdamnthing-0.1.10.tar.gz
Size 163.2 kB
Tags Source
SHA-256 checksum
How to use checksums
ccddbed332327fe61a3e11c051873b653725594ed7366776928b5ff762fa4848
BLAKE2b-256 checksum
How to use checksums
cefde2611247ebb30c9d093e8a6269a0288a2048cc36c84a08f7c6b09e75d8bc
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 Oct 1, 2026.

Transparency log

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

Download URL thisdamnthing-0.1.10-py3-none-any.whl
Size 199.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c4db0abbbfcd0a44bde5f9f6f96dcb762bd1235b5109e13f39b463eec7cfbba8
BLAKE2b-256 checksum
How to use checksums
5d886097c0824adc3a0d4f0d552b03e9b71e76ec8ff90a1a421fb330722df509
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 Oct 1, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.10 This release

2 release files

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

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