agentstack-server-debugging

Debug agentstack-server locally using Telepresence, Lima VM, and mise commands.

1.1k|184|Updated Jan 27, 2025
One-click install
npx skills add https://github.com/i-am-bee/agentstack --skill agentstack-server-debugging
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentstack-server-debugging
Source: https://github.com/i-am-bee/agentstack/tree/main/.claude/skills/agentstack-server-debugging
Command: npx skills add https://github.com/i-am-bee/agentstack --skill agentstack-server-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers debug the agentstack-server component during local development, reducing guesswork and setup time.

Core Features & Use Cases

  • Telepresence-based debugging in a Lima VM environment
  • Run the server locally and verify behavior using the agentstack CLI
  • Validate dev workflows with the mise tooling (start dev cluster, run server, interact via CLI)

Quick Start

Start the development environment by running the following commands: mise run agentstack-server:dev:start mise run agentstack-server:run mise run agentstack-cli:run -- <command>

Frequently Asked Questions about agentstack-server-debugging

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

FAQPage Schema
How do I debug a server locally using Telepresence with a Lima VM?▼

Debugging locally with Telepresence and a Lima VM involves starting a k3s dev cluster, running the server on your machine, and verifying behavior via the CLI using the mise tooling suite.

What is the process to start a local development cluster for agentstack?▼

Starting a local development cluster requires executing the mise run agentstack-server:dev:start command to initialize the k3s environment within your Lima VM.

Do I need mise and k3s running to use this local debugging workflow?▼

Yes, this workflow requires a Lima VM with k3s running, the Telepresence tool active, and the mise command suite to execute the necessary start, run, and verification commands.

How can I verify server behavior through the CLI during local development?▼

You verify server behavior through the CLI by running the mise run agentstack-cli:run -- <command> sequence to interact with the locally running server instance.

Why use Telepresence for local server debugging instead of standard container logs?▼

Telepresence intercepts network traffic to your local machine, allowing you to run the server directly and debug behavior dynamically via the CLI, reducing guesswork compared to standard logs.

What should I check if the Telepresence connection drops during server debugging?▼

If the Telepresence connection drops during server debugging, verify that your Lima VM with k3s is still running and that the dev cluster was started correctly using the mise tooling suite.