af-operate-gidev-server

Manage git worktrees, tmux sessions, and Caddy routing for development servers.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/GainInsightDev/websites --skill af-operate-gidev-server
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: af-operate-gidev-server
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-operate-gidev-server
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-operate-gidev-server

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the management of development server infrastructure, including git worktrees, tmux sessions, and Caddy routing, ensuring efficient and organized development workflows.

Core Features & Use Cases

  • Worktree Management: Create, manage, and clean up git worktrees for specific issues using start-work and stop-work scripts.
  • Port Allocation: Automatically allocates and documents ports for main applications, storybooks, and test reports based on issue numbers.
  • Caddy Configuration: Dynamically configures Caddy to route development URLs to the correct local services.
  • Use Case: When starting work on a new feature (e.g., JCN-4), use start-work juncan JCN-4 to set up a dedicated worktree, configure Caddy, and start a tmux session, all with pre-defined port allocations.

Quick Start

Use the af-operate-gidev-server skill to start work on the juncan project for issue JCN-4.

Frequently Asked Questions about af-operate-gidev-server

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

FAQPage Schema
How do I automate git worktree setup and tmux session creation for a new feature branch?

To automate git worktree setup and tmux session creation, you can use the start-work command with your project and issue key. This script automatically creates an isolated worktree, configures Caddy routing, and starts a tmux session for localized development.

How does Caddy routing configuration work for local development environments?

Caddy routing configuration works by dynamically mapping development URLs to correct local services. When you start work on an issue, the system automatically configures Caddy to route traffic to the specific ports allocated for that isolated development environment.

What is the best way to manage port allocation for multiple isolated development environments?

The best way to manage port allocation is through issue-number-based assignment. The system automatically allocates and documents ports for main applications, storybooks, and test reports, ensuring no conflicts across multiple isolated development environments.

Can I use this workflow to create isolated development environments for specific Jira issues?

Yes, you can create isolated development environments for specific issues. By passing the issue key, such as JCN-4, the workflow sets up a dedicated git worktree, pre-defined port allocations, and a tmux session for that specific task.

How do I clean up git worktrees and tmux sessions when finishing a development task?

To clean up git worktrees and tmux sessions when finishing a task, use the stop-work script with the relevant project and issue key. This safely tears down the isolated development environment and its associated service configurations.