Skip to main content

itda

itda is the TDA CLI for managing tda-manager and tda-worker sessions as a team — starting them, listing them, viewing the manager/worker tree, and stopping a manager together with its workers.

For starting and attaching to individual sessions, see isesh.

Commands​

start​

Create and launch a tda-manager or tda-worker session.

itda start <name> [options]

Run from your own terminal with -w, it creates a tda-manager. Run from inside a tda-manager session, it creates a worker of that manager.

Options:

  • -w, --workspace <path> - Workspace path (the manager's workspace, or the worker's repo; a worker defaults to its manager's workspace)
  • --worker-of <manager> - Parent manager session (creates a tda-worker; default: the calling tda-manager)
  • --manager - Create a tda-manager explicitly (needed when called from inside a manager)
  • --cli <type> - CLI type passed to isesh start --cli

Examples:

# Create a manager session bound to a workspace
itda start myapp-mgr -w ~/projects/my-app

# Create a worker under an existing manager
itda start myapp-backend --worker-of myapp-mgr
note

itda create is a deprecated alias of itda start.

list​

List tda-manager sessions.

itda list [options]

Options:

  • -a, --all - Show all sessions (including inactive)
  • -i, --include <pattern> - Filter sessions matching a pattern (supports * and ? wildcards)
  • -e, --exclude <pattern> - Exclude sessions matching a pattern (supports * and ? wildcards)

Examples:

# List active managers
itda list

# Include inactive sessions
itda list -a

# Only sessions starting with "myapp"
itda list -i 'myapp*'

tree​

Display the manager/worker relationship tree.

itda tree [options]

Options:

  • -a, --all - Show all sessions (including inactive)
  • -i, --include <pattern> - Filter sessions matching a pattern (supports * and ? wildcards)
  • -e, --exclude <pattern> - Exclude sessions matching a pattern (supports * and ? wildcards)
  • --status - Show each session's work state and a verdict per manager team (--json for JSON output)

Example:

# Show the full team tree, including inactive sessions
itda tree -a

# Show what each session in the team is doing
itda tree --status

describe​

Set a description for a session.

itda describe <name> <description>

Example:

itda describe myapp-backend "Backend API and database work"

stop​

Stop a tda-manager session and its workers. Cascade is the default — stopping a manager also stops its workers.

itda stop <manager> [options]

Options:

  • --keep-workers - Stop only the manager, keep its workers running
  • --workers-only - Stop only the workers, keep the manager running
  • --dry-run - Show what would be stopped without stopping anything

Examples:

# Stop the manager and all its workers (default)
itda stop myapp-mgr

# Preview what would be stopped
itda stop myapp-mgr --dry-run

# Stop only the workers, keep the manager
itda stop myapp-mgr --workers-only

See Also​