poolside

Configure the Poolside ACP agent runtime for printer CLI and heyvm sandbox integration.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/Heyo-Computer/heyo-public --skill poolside
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: poolside
Source: https://github.com/Heyo-Computer/heyo-public/tree/main/plugins/poolside/skills/poolside
Command: npx skills add https://github.com/Heyo-Computer/heyo-public --skill poolside

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves configuration and runtime friction when operating the Poolside ACP agent within the printer environment, ensuring proper authentication and state management.

Core Features & Use Cases

  • Environment Synchronization: Manages the mapping of local state and configuration directories like .poolside and ~/.local/state/poolside/ into the printer sandbox.
  • Authentication Handling: Facilitates secure credential loading from ~/.config/poolside/credentials.json or environment variables.
  • Use Case: When launching the pool CLI in acp server mode via printer, this skill ensures the agent correctly interprets the workspace context and maintains persistent session logs across multiple runs.

Quick Start

Activate the poolside skill to initialize the ACP runtime and begin managing your project configuration within the printer environment.

Frequently Asked Questions about poolside

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

FAQPage Schema
How do I configure the ACP agent runtime to maintain persistent state in a sandbox?

To configure the ACP agent runtime, you must map local state directories like .poolside and ~/.local/state/poolside/ into the sandbox environment. This ensures persistent session logs are maintained across multiple agentic workflow runs.

How does authentication work for the Poolside ACP agent within the printer CLI?

Authentication for the Poolside ACP agent is handled by securely loading credentials from ~/.config/poolside/credentials.json or environment variables. This facilitates secure credential loading directly within the printer environment.

Can I use the ACP agent with the printer CLI without manual environment variable handling?

Yes, the Poolside skill automatically satisfies specific environment variable handling and filesystem path discipline required by the Agent Client Protocol. You do not need to manually manage these variables when launching the pool CLI in acp server mode.

What is the best way to integrate ACP agent workflows with the heyvm sandbox?

The best way to integrate ACP agent workflows with the heyvm sandbox is to activate a configuration skill that manages per-project configuration mapping. This ensures the agent correctly interprets workspace context and resolves runtime friction.

Why does my ACP agent lose session context when launching the pool CLI in acp server mode?

Your ACP agent loses session context because local state and configuration directories are not properly mapped into the printer sandbox. Correctly mapping .poolside directories ensures the agent maintains persistent session logs across runs.