pepper-state

Read, write, append, and list persistent state via the Pepper Cloud API.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/marmikcfc/pepper-skills --skill pepper-state
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pepper-state
Source: https://github.com/marmikcfc/pepper-skills/tree/main/skills/pepper-state
Command: npx skills add https://github.com/marmikcfc/pepper-skills --skill pepper-state

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages persistent workspace state across Pepper Cloud sessions by reading, writing, and appending to a centralized state tree.

Core Features & Use Cases

  • Read, write, append, and list state data to maintain context across agent sessions.
  • Hydrate strategy, ICP, metrics, bets, and related artifacts at the start of a workflow and persist results for future runs.
  • Define and interact with a canonical state tree for GTM operations (strategy/, icp.md, bets/, metrics/ daily logs, etc.).

Quick Start

Load the workspace state from Pepper Cloud at startup before acting.

Frequently Asked Questions about pepper-state

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

FAQPage Schema
How do I persist workspace state across cloud agent sessions?

To persist workspace state across cloud agent sessions, you can use this Skill to read, write, and append data to a centralized state tree via the Pepper Cloud API, ensuring long-term context is maintained.

What is the best way to hydrate strategy and ICP context for a workflow?

Hydrating strategy and ICP context involves loading workspace state at startup before acting. This Skill retrieves persisted artifacts like strategy and ICP files from the centralized state tree for immediate workflow use.

Can I append new metrics to existing daily logs in Pepper Cloud?

Yes, you can append new metrics to existing daily logs in Pepper Cloud. The Skill uses the state_append helper endpoint to add data to existing state paths without overwriting previously persisted metrics.

Does this state management approach require specific API endpoints?

Yes, this state management approach requires the Pepper Cloud API. It specifically relies on the helper endpoints state_read, state_write, state_append, and state_list to access and modify state paths.

When do I need cross-session persistence for GTM operations?

You need cross-session persistence for GTM operations when maintaining a canonical state tree across multiple runs. This Skill allows you to define and interact with directories for strategy, bets, and metrics over time.