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.