TinkerTasker CLAUDE.md

A project guide for TinkerTasker, an application split between AI services and a command-line interface. It explains the code layout and design rules for keeping the implementation small.

In plain words
What is it for?
Use it when reading, designing, or modifying TinkerTasker code, especially across its AI-core and command-line components.
Why use it?
It gives a coding agent the project context needed to make changes that fit the existing structure. This reduces unnecessary abstractions and avoids building for requirements that do not exist.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/davecodev/tinkertasker/claude-md
Clone the repo
git clone --depth 1 https://github.com/DaveCoDev/TinkerTasker
Per session 1,000 This file is loaded in full into every session.
When invoked 1,000 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01000 $0.01000
Opus 5 $0.00500 $0.00500
Sonnet 5 $0.00200 $0.00200
Haiku 4.5 $0.00100 $0.00100

Measured 2d ago against content hash fdf884d0819a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

TinkerTasker CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 88 lines

How it starts

The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Project README

@README.md

Project Structure

TinkerTasker is broken up into two main components: ai-core: Contains the core AI functionality, including the MCP servers for filesystem and web. This is the pyproject.toml for the package @./ai-core/pyproject.toml

cli-ux: Provides the command-line interface for interacting with TinkerTasker. This is the pyproject.toml for the package @./cli-ux/pyproject.toml

Core Design Principles

Ruthless Simplicity

  • KISS principle taken to heart: Keep everything as simple as possible, but no simpler
  • Minimize abstractions: Every layer of abstraction must justify its existence
  • Start minimal, grow as needed: Begin with the simplest implementation that meets current needs
  • Avoid future-proofing: Don't build for hypothetical future requirements
  • Question everything: Regularly challenge complexity in the codebase

Architectural Integrity with Minimal Implementation

  • Preserve key architectural patterns: MCP for service communication, SSE for events, separate I/O channels, etc.
  • Simplify implementations: Maintain pattern benefits with dramatically simpler code
  • Scrappy but structured: Lightweight implementations of solid architectural foundations
  • End-to-end thinking: Focus on complete flows rather than perfect components

Library Usage Philosophy

  • Use libraries as intended: Minimal wrappers around external libraries
  • Direct integration: Avoid unnecessary adapter layers
  • Selective dependency: Add dependencies only when they provide substantial value
  • Understand what you import: No black-box dependencies

Testing Strategy

  • Emphasis on integration and end-to-end tests
  • Manual testability as a design goal
  • Focus on critical path testing initially
  • Add unit tests for complex logic and edge cases

Areas to Embrace Complexity

Some areas justify additional complexity:

  1. Security: Never compromise on security fundamentals
  2. Data integrity: Ensure data consistency and reliability
  3. Core user experience: Make the primary user flows smooth and reliable
  4. Error visibility: Make problems obvious and diagnosable

Read the full file on GitHub · 88 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 88 lines · 1,000 tokens per session scan A fdf884d0819a

Subscribe to this mod's changes

TinkerTasker CLAUDE.md is an instructions file published in the GitHub repository DaveCoDev/TinkerTasker (5 stars, last pushed 1y ago), licensed MIT. It adds 1,000 tokens to every session, about $0.0050 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.