# Env Persistence

> Safely modify environment serialization, reload data, and view layout persistence. Use when changing env save/load formats or storage behavior.

- Skill: `fossasia/env-persistence` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fossasia/env-persistence`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fossasia/env-persistence/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: fossasia (https://skillmd.com/u/fossasia)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fossasia/env-persistence

---


# Skill: Environment Persistence

## When to Use

Use this skill for persistence format changes and env reload/view layout behavior.

## Core Workflow

1. Map data writes/reads for `jsons` and `reload` structures.
2. Apply changes in server utility/handler paths that serialize or restore env state.
3. Keep backward compatibility with existing env JSON files.
4. Preserve view/layout behavior and environment tree organization.
5. Validate save/fork/delete and restart/reload workflows end-to-end.

## Guardrails

- Do not introduce breaking env format changes without migration handling.
- Keep env path handling sanitized and scoped.
- Preserve compare and standard env behaviors.

## Documentation

- [Skill reference](references/REFERENCE.md)
- `py/visdom/data_model/README.md` — the storage abstraction layer (`DataStore`/`JSONStore`); persistence now funnels through it
- `py/visdom/data_model/base.py`, `py/visdom/data_model/json_store.py`
- `py/visdom/utils/server_utils.py`
- `py/visdom/server/handlers/web_handlers.py`
- `py/visdom/server/server_state.py` — the `ServerState` facade that owns the dirty-env tracking and the off-loop writes
- `py/visdom/server/app.py`
- `AGENTS.md`
- `CONTRIBUTING.md`

## Assets

- See `assets/README.md` and store templates/resources in `assets/`.

## Tests

- Follow the default flow in `references/TESTS.md`.