Dotfiles project knowledge
Bundle OKF 0.2 · 7 conceitos · arecarn/dotfiles
Open source Repository Open in the app JSON README (API)
About
# Dotfiles project knowledge
Reference material for this repository. Read an entry when its description
matches the task; these are facts and procedures, not instructions.
# Subsystems
* [Agent knowledge](agent-knowledge.md) - where the resolver, CLI, and the three
harness adapters live, the two rules that are easy to break, and when a bundle
needs no tooling at all
* [Pi configuration](pi.md) - what lives in `pi/.pi/agent/`, how a pi package is
declared, and the fold barrier a package with its own config must get or its
files land in this public repo
* [MCP servers](mcp.md) - adding or changing a server in the one manifest that
feeds every harness, and where credentials may not go
* [Provisioning](provisioning.md) - adding a package or an Ansible task file, the
Linux/Windows split that leaves a change half-done, the Debian binary that is
not named after its package, and why a failed install still reports success
# Elsewhere in the repo
* [Decisions](../docs/adr/) - architecture d
Details
- Kind
- OKF bundles
- Topic
- Cloud & DevOps
- Publisher
- arecarn
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Stars
- 4
- Last push
- 2026-09-08T22:09:42Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-09-08 22:07:22
- Updated
- 2026-09-08 22:07:22
- Origin id
arecarn/dotfiles:agents-knowledge/index.md
README
# dotfiles Personal configuration files managed with [dploy](https://github.com/arecarn/dploy) and [invoke](https://www.pyinvoke.org/). ## Setup ```sh uv sync pnpm install # TypeScript toolchain; `inv lint` needs it uv run inv stow # symlink configs to $HOME uv run inv provision # install packages via ansible (Linux) or chocolatey (Windows) ``` ## Tasks | Task | Description | |------|-------------| | `stow` | Symlink dotfiles to home directory | | `unstow` | Remove symlinks | | `provision` | Install system packages | | `lint` | Run shellcheck, yamllint, pylint, ruff, biome, tsc |