blog-

PICOS: Engineering Logs

A terminal-native documentation system for the pic project. *Version 1.0.0 | [picos.dev](https://blog.picos.dev

01. Intro

This is not just a blog; it is a functional extension of the PIC identity. The goal is to create a "bare-metal" engineering aesthetic that treats documentation with the same rigor as code.

The interface is a Hybrid Shell:

• Power Users: Navigate via stdin commands (cd, cat, ls, grep).
• Mobile Users: Navigate via standard touch interactions without losing the terminal aesthetic.

02. The Tech Stack

• Core Engine: Hugo Extended (v0.127.0)
• Architecture: Static Site Generator (SSG) with Client-Side Hydration
• Theme: Inspired by the hugo-theme-shell
• Search/Index: Local index.json generation (No external search services)
• Hosting: Cloudflare Pages (Build System v3)
• CMS Workflow: Obsidian (Local Vault) -> Git Push -> Cloudflare Deploy

03. Features

• Interactive TUI: Full command history, tab-completion, and directory traversal.
• Nano-Mode: Reading articles simulates the nano/pico text editor environment, complete with keyboard shortcuts (^X to exit, ^O to open web link).
• Hybrid Navigation: Users can click to navigate or type commands.
• Frozen State Automation: Documentation on the "Wake & Freeze" GPU protocols used in the backend infrastructure.
• Offline-First: The entire filesystem structure is loaded into a client-side JSON object on first load.

04. Local Development

Prerequisites

• Hugo Extended v0.127.0+
• Go 1.22+

Quick Start

# 1. Clone the repository (Use the "No-Reply" config if privacy is required)
git clone [https://github.com/picos-dev/blog-.git](https://github.com/picos-dev/blog-.git)

# 2. Run the local server
hugo server -D

# 3. Access the terminal
# Open http://localhost:1313/terminal