SPRUCE GROVE OS
gran · lund · sv. · spruce grove — an agentic coding CLI grown in the grove.
Together we are better. Always.
Spruce Grove OS is a full custom instance of an agentic coding assistant: the same engine, frameworks, plugins, agents, tools, skills, MCP plumbing, and TUI as the project it is inspired by — replanted around one grove's vision, mission, and values.
Inspired by Code Puppy
Every trail in this grove started as a Code Puppy trail. Spruce Grove OS is built directly from — and stays import-compatible with — Code Puppy by Michael Pfaffenberger (MIT licensed). Huge respect to the original project and its contributors; this grove exists because the puppy shared everything. Exact lineage, sync points, and the full rename/contract map: PROVENANCE.md.
The ethos of the grove
Three sources, one creed — ETHOS.md:
- Ozark Bagels — how to carry yourself. Be first to say hello. Be kinder than necessary. Be tough minded, but tender hearted. Leave everything better than you found it. Spread joy, love, and cream cheese.
- The Junto (1727) — how to think with others. Love truth for truth's sake. No invented facts — ever; cite or flag "NOT VERIFIED". Provisional phrasing over contradiction combat. Pragmatism over metaphysics.
- gran·lund — who is doing the carrying. Help people solve problems. Remove technology obstacles. Meet people where they are, as humans.
Meet Cedar
The default agent persona is Cedar, the grove guide — same competent
agent core, new disposition: candid about code, gentle with people, allergic
to invented facts. Rename it anytime in grove.cfg.
Design system
Nordic forest, dark-first. Charcoal base, deep spruce, warm cedar accents, mist typography. Tokens shared with tylergranlund.com — the same palette that colors the terminal splash.
Color tokens
| Token | OKLCH | Role | Chip |
|---|---|---|---|
| charcoal | oklch(0.18 0.012 150) |
base background |  |
| spruce-deep | oklch(0.22 0.03 158) |
deep brand layer |  |
| spruce | oklch(0.32 0.045 158) |
primary brand |  |
| moss | oklch(0.45 0.06 155) |
accent green |  |
| cedar | oklch(0.78 0.12 55) |
warm accent, persona |  |
| bark | oklch(0.32 0.025 60) |
earthy neutral |  |
| stone | oklch(0.85 0.012 90) |
soft UI text |  |
| mist | oklch(0.94 0.008 100) |
foreground/typography |  |
Typography
- Fraunces (variable serif) — wordmarks and display
- Inter — body copy
- JetBrains Mono — code, CLI output
Terminal theming
The boot splash renders a shimmering pyramid + figlet lockup
("SPRUCE GROVE", compact "GROVE" on narrow terminals) in a truecolor
canopy-to-cedar gradient: halo #2D4F3A → glow #588F5E → core #D2A069,
with a mist-white crest (#F0E1C8) where the sheen passes. ANSI fallbacks
step down through green → bright green → yellow.
Voice
Plain-spoken, warm, a little playful. First to say hello. Candid, never roasty. Zero invented facts — "NOT VERIFIED" beats a confident guess.
Full tokens and voice guide: BRAND.md.
What's inside (same bones as Code Puppy)
┌──────────────────────────────────────────────────┐
│ TUI / CLI (command_line/) │
├──────────────────────────────────────────────────┤
│ Agent Layer (agents/) — Cedar default + JSON │
├──────────────────────────────────────────────────┤
│ Tool Layer (tools/) — TOOL_REGISTRY │
├──────────────────────────────────────────────────┤
│ Plugin Layer (plugins/, callbacks.py) │
├──────────────────────────────────────────────────┤
│ Model Layer (model_factory.py) │
├──────────────────────────────────────────────────┤
│ pydantic-ai + MCP (external) │
└──────────────────────────────────────────────────┘
Python 3.11–3.14 · pydantic-ai · pluggable models (OpenAI, Anthropic, Gemini, Bedrock, Z.AI, custom endpoints) · MCP servers · skills with namespaces · session history + compaction · i18n.
Install & run
git clone https://github.com/t-granlund/SPRUCE-GROVE-OS
cd SPRUCE-GROVE-OS
uv sync
uv run spruce-grove # or: uv run grove
Config: ~/.spruce_grove/grove.cfg · Env vars: SPRUCE_GROVE_*.
Code Puppy compatibility
code_puppy.*imports (e.g. fromcode-puppy-core-plugins) resolve tospruce_grove.*via an import shim with true module identity.- The plugin entry-point group
code_puppy.pluginsis intentionally retained. - Legacy aliases kept:
agent_code_puppy,CodePuppyAgent,get_puppy_name(), persistedpuppy_namefallback. - Full contract ledger: PROVENANCE.md.
License
MIT — inherited from Code Puppy. See LICENSE and attribution in PROVENANCE.md.
1 maintainer
Release files for spruce-grove 1.0.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| spruce_grove-1.0.13.tar.gz | 893.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| spruce_grove-1.0.13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.0 MB
Release files / spruce_grove-1.0.13.tar.gz
| Download URL | spruce_grove-1.0.13.tar.gz |
|---|---|
| Size | 893.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dfceaf2ecfd0419cd54d0ffa014abab43de819ca1ef2b03011f8196cb6525a47
|
|
BLAKE2b-256 checksum How to use checksums |
07256f092763a18994a8a4a6bbe641e9704a87f20a2421e88f2bf81448eb2528
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.
Transparency logRelease files / spruce_grove-1.0.13-py3-none-any.whl
| Download URL | spruce_grove-1.0.13-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
af856cf576cb9a1da1c9e19c024ef0b430cc4486b1e73366215ebcd5e9f22cc7
|
|
BLAKE2b-256 checksum How to use checksums |
9524e93dfb56b2347600aa5d04a56b82cd04bbb4b474ef3a0017e186cc56292d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.
Transparency log
