tezraJOURNAL

TEZRA / Engineering journal

Systems that
live closer to home.

Engineering notes on running your own infrastructure, from the first decision to everyday operations.

Story 03 / AI assistants · macOS · Access

AI assistant secrets: macOS Keychain and agent skills

Connect macOS Keychain to an AI assistant with an access registry, a local helper and SKILL.md. A working GitLab example that keeps tokens out of tool output.

12 min read
Read the story
The access workflowTZ / 03
01 / REQUESTAI / SkillSelect the exact target
02 / EXECUTIONLocal helperRead Keychain · HTTPS
03 / RESULTGitLab APIRead request · status
KeychainToken → helper → API. The chat receives a status.
The secret stays out of normal tool output. Executor permissions are a separate control.

Story 02 / Development · CI/CD · AI agents

A home development server: GitLab, OrbStack and AI agents

How self-hosted GitLab, CI workers and OrbStack on a Mac shorten the path from code to release, with Codex workflows and six proposed agent skills.

16 min read
Read the story
From an edit to a verified releaseTZ / 02
01 / LOCALMac + OrbStackCode · run · debug
02 / CIGitLab + workersCheck · build · artifact
03 / RELEASEVerify + releaseVersion · journey · rollback
Codex / AISkills connect the steps: context → action → check
A proposed workflow. Server resources run heavy jobs; the agent uses tools and verifies the result.

Story 01 / Home infrastructure

Home Kubernetes: a smart home, Zigbee and a personal cloud

How one home server brings together Nextcloud, email and media — and how Home Assistant, Zigbee2MQTT and a SONOFF coordinator can extend it.

10 min read
Read the story
One server · shared platformTZ / 01
Nextcloud / SMBStalwart / PlexTranscription / GPU
KubernetesSINGLE NODE
Home AssistantMQTT / Zigbee2MQTTSONOFF / Zigbee
Left: existing server services, including SMB on the host. Dashed: the proposed smart-home setup; the SONOFF coordinator sits outside Kubernetes.
Practical experience · official documentationEN / RU · Infrastructure · Development · AI