teds-start

A command that starts a long-term task using TEDS, a system for organizing extended coding work with plans, status, context, logs, and a knowledge base.

In plain words
What is it for?
Use it to start named tasks such as authentication refactoring, database migration, or OAuth implementation, optionally including a description.
Why use it?
It creates the task records and folder structure needed to track work across multiple sessions.

Command

Part of the teds-plugin plugin — 6 commands, 5 agents shipped together

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 commands/legacybridge-tech/claude-plugins/teds-start
Clone the repo
git clone --depth 1 https://github.com/legacybridge-tech/claude-plugins

Or install teds-plugin, the plugin that ships this one along with the rest of its 6 commands, 5 agents.

Per session 9 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 540 The whole file, excluding the scripts and references it only reads on demand.
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.00009 $0.00540
Opus 5 $0.00005 $0.00270
Sonnet 5 $0.00002 $0.00108
Haiku 4.5 $0.00001 $0.00054

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

Security

Grade A, and why

teds-start 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 3d 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.

teds/commands/teds-start.md · 84 lines

How it starts

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

Start New TEDS Task

Launch the teds-initializer agent to create and initialize a new long-term task.

Usage

/teds-start task-name [optional-description]

Examples

# Simple task
/teds-start refactor-auth

# With description
/teds-start migrate-database "Migrate from MySQL to PostgreSQL"

# Complex project
/teds-start implement-oauth "Implement OAuth 2.0 authentication system with Google and GitHub providers"

What This Does

The agent will:

  1. Load TEDS configuration (from CLAUDE.md or .teds-config.yaml)
  2. Generate a unique task ID (format: YYYYMMDD-HHMM-taskname)
  3. Create complete directory structure for the task
  4. Initialize all documentation files:
    • manifest.yaml - Task metadata
    • plan.md - Execution plan (will work with you to define)
    • execution_log.md - Action logging
    • knowledge_base.md - Learnings repository
    • context.md - Background and constraints
    • status.yaml - Current state
  5. Set initial status to "active"
  6. Begin planning with you

Task Naming Guidelines

Good task names:

  • refactor-auth - Clear and concise
  • migrate-database - Specific action
  • implement-oauth - Feature-focused

Avoid:

  • task1 - Too generic
  • fix-bug - Not specific enough
  • update-everything - Too broad

After Initialization

Once the task is initialized, you'll see:

✅ Task initialized: 20250116-1430-refactor-auth
Location: claude_work_space/active_tasks/20250116-1430-refactor-auth/
Status: Ready to begin

The agent will then help you:

  1. Define detailed phases in plan.md
  2. Set success criteria
  3. Document context and constraints
  4. Begin execution with continuous logging

Continuing Later

To resume this task in a future session:

/teds-continue 20250116-1430-refactor-auth
  • /teds-status - View all tasks
  • /teds-continue [task-id] - Resume a task
  • /teds-checkpoint - Save progress
  • /teds-complete [task-id] - Finish and archive

Read the full file on GitHub · 84 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. 3d ago First seen · 84 lines · 9 tokens per session scan A 0d797735ab0a

Subscribe to this mod's changes

teds-start is a command published in the GitHub repository legacybridge-tech/claude-plugins (6 stars, last pushed 3mo ago), licensed MIT. It adds 9 tokens to every session and 540 once invoked, about $0.0000 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.