af-gidev-server

Manage GiDev server operations with git worktrees, tmux sessions, Caddy routing, and port allocation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the management of GiDev server environments, simplifying complex tasks like worktree creation, Caddy routing, and port allocation.

Core Features & Use Cases

  • Worktree Management: Create, manage, and clean up git worktrees for specific issues using start-work and stop-work scripts.
  • Server Configuration: Configure Caddy routing for development URLs and manage port allocations based on project and issue numbers.
  • Use Case: When starting work on a new feature for the 'juncan' project, use start-work juncan JCN-4 to automatically set up a dedicated worktree, configure its development server URL, and allocate necessary ports.

Quick Start

Use the start-work command to begin work on the juncan project issue JCN-4.

Frequently Asked Questions about af-gidev-server

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

FAQPage Schema
How do I manage git worktrees and allocate ports for development server environments?

To manage git worktrees and allocate ports, use deterministic start-work scripts to create dedicated worktrees and assign necessary ports based on project and issue numbers. This ensures proper server environment setup for development workflows.

How does Caddy routing work for development URLs in a worktree setup?

Caddy routing for development URLs is configured automatically when you start work. The server management scripts configure Caddy to route development traffic to the correct worktree based on your specific project and issue number.

What is the best way to set up a dedicated worktree for a specific project issue?

The best way to set up a dedicated worktree is by running the start-work command with your project and issue identifier, such as start-work juncan JCN-4. This automatically creates the worktree, configures routing, and allocates ports.

Can I use tmux sessions with automated git worktree and Caddy configuration?

Yes, tmux sessions are integrated into the server environment management. The tooling facilitates deterministic task execution through tmux alongside git worktree creation and Caddy routing for isolated development workflows.

How do I clean up git worktrees and deallocate ports when finishing development work?

To clean up git worktrees and deallocate ports, use the stop-work scripts. These scripts ensure proper server environment cleanup by removing the dedicated worktree and releasing the assigned resources when work is complete.

Do I need to manually configure port allocation when starting work on a new feature?

No, you do not need to manually configure port allocation. The start-work script automatically handles port allocation based on your project and issue numbers, ensuring deterministic task execution without manual server configuration.