workspace

Automate workspace lifecycle management across multiple repositories with git worktrees and database provisioning.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/souliane/teatree --skill workspace-souliane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace
Source: https://github.com/souliane/teatree/tree/main/skills/workspace
Command: npx skills add https://github.com/souliane/teatree --skill workspace-souliane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, docker, postgresql, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the setup, management, and cleanup of workspaces, ensuring a seamless and efficient workflow for complex projects.

Core Features & Use Cases

  • Worktree Creation: Automatically creates synchronized git worktrees across multiple repositories for a single ticket.
  • Database Provisioning: Provides isolated databases and ports for each worktree.
  • Service Management: Manages the startup, status, and teardown of services within the worktree.
  • Cleanup: Automates the cleanup of merged worktrees, orphaned databases, and other resources.
  • Use Case: Imagine you have a complex project with multiple components and dependencies. Use this Skill to automatically set up a workspace, provision all necessary resources, and clean up afterward, saving time and reducing manual errors.

Quick Start

Use the workspace skill to create a new workspace for a ticket with the following command: t3 <overlay> workspace ticket <issue-url-or-id>

Frequently Asked Questions about workspace

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

FAQPage Schema
How do I automate git worktree creation for multiple repositories?

Automating git worktree creation involves generating synchronized worktrees across multiple repositories for a specific ticket, provisioning isolated databases and ports, and managing service orchestration to streamline complex development workflows.

How does automated database provisioning work for isolated development workspaces?

Automated database provisioning allocates isolated PostgreSQL databases and network ports for each individual worktree, ensuring development environments remain completely segregated and preventing resource conflicts during concurrent service orchestration.

Do I need Docker and PostgreSQL to manage automated workspace lifecycles?

Yes, managing automated workspace lifecycles requires Git, Docker, and PostgreSQL installed in your environment to properly handle worktree synchronization, containerized service orchestration, and isolated database allocation.

What is the best way to clean up orphaned databases and merged git worktrees?

The best way to clean up orphaned databases and merged git worktrees is to automate the teardown process, which systematically removes merged worktrees, deallocates provisioned ports, and drops isolated databases.

Can I use automated workspace setup for CI/CD pipelines and infrastructure management?

Yes, automated workspace setup directly supports CI/CD pipelines and infrastructure management by applying synchronized worktree creation, database provisioning, and service orchestration to streamline continuous integration workflows.

How do I start a new workspace using a specific ticket ID?

You start a new workspace by executing the command `t3 <overlay> workspace ticket <issue-url-or-id>`, which automatically initializes the synchronized worktrees, provisions the database, and allocates the necessary ports.