setup

Install the ttal CLI, initialize the workspace, and configure Telegram bot control.

23|2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/tta-lab/ttal-cli --skill setup-tta-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/tta-lab/ttal-cli/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/tta-lab/ttal-cli --skill setup-tta-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

First-time ttal users need a reliable, step-by-step way to install ttal, initialize the workspace, configure required tooling, and optionally enable Telegram control without missing critical setup pieces.

Core Features & Use Cases

  • Automated installation and verification: Detects whether ttal is present, installs it for the user's platform, and verifies it with a version check.
  • End-to-end onboarding for the local workspace: Runs ttal onboarding to scaffold the workspace, configure taskwarrior, install the daemon, and set worker hooks.
  • Optional Telegram integration setup: Guides the user through obtaining chat_id, creating agent bots, storing tokens safely in config and .env, then restarts the daemon and runs doctor checks.

Quick Start

Run this skill by executing the ttal onboard setup flow with ttal onboard.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up and initialize a workspace with taskwarrior and ttal for the first time?

Workspace initialization with ttal runs ttal onboard to scaffold the workspace, configure taskwarrior, install the daemon, and set worker hooks for team workflows.

Can I control my agents from a phone using Telegram during workspace onboarding?

Telegram integration setup guides you through obtaining chat_id, creating agent bots, storing tokens safely in ~/.config/ttal and .env, then restarting the daemon.

What does the ttal doctor health validation check after workspace initialization?

Final health validation via ttal doctor verifies the daemon, hooks, taskwarrior configuration, and agent credentials are correctly configured before running team workflows.

Do I need to manually install the ttal CLI before running the onboarding flow?

Automated installation detects whether the ttal CLI is present, installs it for your platform, and verifies it with a version check before proceeding with workspace onboarding.

How do I fix missing or incorrect configuration pieces during ttal onboarding?

Running ttal onboard with the optional --fix flag applies safe token and config updates in ~/.config/ttal to resolve missing or incorrect configuration pieces.

What prerequisites are required before configuring daemon and hooks for team workflows?

A new clone of a ttal workspace template is required, where daemon, hooks, taskwarrior configuration, and agent credentials must be configured before running team workflows.