convez.ai
SkillProdutividadeIntermediário
BenaliHQ

WorkDesk OS

BenaliHQ/workdesk-configuration

Obsidian + Claude Code como sistema de trabalho em conhecimento estruturado

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema de superfície de trabalho integrado que combina Obsidian com Claude Code em uma arquitetura de cinco zonas para gerenciamento de conhecimento e trabalho assistido por IA. Inclui seis meta-skills extensíveis, eventos semânticos rastreados e bootstrap automático para Mac, transformando um vault vazio em uma estação de trabalho estruturada.

Instalação

$npx convez-ai BenaliHQ/workdesk-configuration

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
3
Acompanhando
0
Saúde
62%
Último commit
há 3 dias
Versão
v2.3.1
Issues abertas
23
Contribuidores
1

Casos de uso

  • Gestão de projetos e ações (GTD) com suporte de agente IA
  • Síntese de informações multi-fonte com signals gerenciados
  • Criação de objetos identificáveis como single-source-of-truth
  • Automação de rotinas de conhecimento sem código (meta-skills)
  • Auditoria de atividades via eventos semânticos com hooks

Veredito

WorkDesk OS é um framework ambicioso de engenharia de prompts + automação que materializa um sistema de trabalho em conhecimento via Obsidian. A restrição Mac-only e vault greenfield limitam adoção imediata, mas a arquitetura markdown-nativa e portabilidade entre modelos oferecem durabilidade — ideal para operadores que querem estrutura sem UI declarativa.

README

A tradução para o português deste README ainda está na fila.

WorkDesk OS

A giveable Obsidian + Claude Code working surface for knowledge work with AI.

WorkDesk OS turns a fresh vault into a five-zone, agent-guided system that captures your work, surfaces signal, and keeps up with your life. You experience it as furniture — not an application.

V1 status. Mac-only. Greenfield (empty vault) only. The vault content architecture is OS-agnostic; only the install/runtime layer is Mac-specific.

What ships

Five zones. Each zone manages one unit type and has one job.

ZoneUnitJobAgent writes?
personal/practicePractice management (journal, daily, reading)Never — read-only
atlas/objectObject management — single-source identifiedYes
gtd/actionAction management — projects, actions, inboxYes
intel/signalSignal management — multi-source synthesisYes
system/sourceSource management — raw inputs + activity infraYes (hooks)

Six meta-skills for extending the system without code: /define-object, /define-signal, /define-source, /define-practice, /define-tool, /define-rule.

Three pre-built signals. daily-plan (rich → sparse → cold-start fallback), weekly-review (mandatory, active week 1), vault-improvements (suppressed first 14 days).

Eleven semantic event classes logged via a PostToolUse hook to monthly event files in system/events/{YYYY-MM}.md.

Codex rescue — vault is plain markdown, model-portable. If Claude is down, /codex-rescue packages context for OpenAI Codex CLI.

Install

Three steps, each one-click:

  1. Install Obsidian (≥1.12.2) from https://obsidian.md/download — drag to /Applications, open it once, approve any macOS prompts, then quit.
  2. Install Claude Code from https://claude.com/claude-code.
  3. Run the install:
curl -fsSL https://raw.githubusercontent.com/BenaliHQ/workdesk-configuration/main/init.sh | bash

Defaults: vault at ~/Workdesk-OS/. Configure via env vars:

Env varDefaultPurpose
WORKDESK_VAULT_PATH~/Workdesk-OS/Vault location
WORKDESK_INIT_DRYRUNunsetPrint the plan, no writes
WORKDESK_INIT_FORCEunsetReuse a non-empty vault per ownership list
WORKDESK_INIT_OPENunsetLaunch Obsidian at the new vault on success

The orchestrator verifies prerequisites (Obsidian present + version + non-quarantined, Claude Code on PATH, Obsidian not currently running), downloads the pinned tarball, runs bootstrap.sh, vendors BRAT (the only bundled plugin) with SHA256 verification per artifact, and registers the vault in Obsidian's registry. No sudo, no Homebrew, no Xcode CLT. All macOS-native tooling.

Other plugins (workdesk-terminal, surface appearance, calendar, periodic-notes, templater, minimal-settings, custom-sort) are opt-in via BRAT from inside Obsidian once the install completes — operators choose what they want, nothing is pre-installed by the WorkDesk OS distribution.

Preview without writing anything:

WORKDESK_INIT_DRYRUN=1 curl -fsSL https://raw.githubusercontent.com/BenaliHQ/workdesk-configuration/main/init.sh | bash

bootstrap.sh remains as the lower-level primitive — advanced users can invoke it directly with a path argument — but init.sh is the V1.1 user-visible install.

First session

cd /path/to/empty-vault
claude

Then:

  1. /workdesk-doctor — verifies hooks, locks, and runtime behavior
  2. /onboarding — six phases, ~10 minutes, captures your role mix
  3. /daily-ops — first daily plan
  4. /weekly-review at end of week 1

Architecture

LayerWhatWhere
Vault contentYour workpersonal/ atlas/ gtd/ intel/ system/
Control planeDeclarations, scripts, hooksconfig/ (visible) + .claude (symlink)
SkillsWorkflow entry pointsconfig/skills/
RulesHard constraintsconfig/rules/
DeclarationsObject/signal/source/practice/tool definitionsconfig/{objects,signals,sources,practices,tools}/

The config/ directory is the visible source of truth. Claude Code reads through .claude/ (a symlink) for tool compatibility.

Bootstrap also creates config/defaults/ — a frozen snapshot of the control plane as it shipped. Treat it as read-only. The /update skill 3-way merges defaults/ (what shipped), config/ (what you have now), and each new release — keeping your edits, applying release changes to untouched files, and walking you through any conflicts. Editing defaults/ defeats the merge.

Extending

Six meta-skills cover everything you'll add over time. Each scaffolds a declaration and creates the corresponding vault folder when needed. Each carries a detection clause — a deterministic rule for when Claude should propose creating something, not just when you ask.

SkillScaffolds
/define-objectAtlas content types (book, vendor, deal, anything structured)
/define-signalIntel signal types (briefings, observations)
/define-sourceSystem source types (bookmark, screenshot, ocr)
/define-practicePersonal practice types (journal, reading log)
/define-toolClaude capabilities (CLI, API, MCP server)
/define-ruleBehavioral constraints

/define-skill, /define-agent, /define-zone are explicitly not in V1.

Resilience

  • Codex rescue — vault content is plain markdown, fully portable. /codex-rescue hands the active task to OpenAI Codex with full context.
  • Sparse-data daily-plan — useful output even with no calendar, no transcripts, three manual notes.
  • Hook fallbacks — /workdesk-doctor chooses SessionEnd (preferred) or Stop (upserted, one file per session_id) for raw transcript export.

Vendored components

As of v1.4.0, WorkDesk OS bundles a single Obsidian plugin under vendor/plugins/: BRAT (Beta Reviewers Auto-update Tool). BRAT is the gateway — operators install everything else they want (workdesk-terminal, surface appearance, calendar, periodic-notes, templater, minimal-settings, custom-sort, etc.) opt-in from inside Obsidian using BRAT's "Add a beta plugin" command. BRAT's release artifacts (main.js, manifest.json, styles.css) are vendored at a pinned upstream tag, with SHA256s recorded in vendor/plugins/obsidian42-brat/UPSTREAM.md and verified by init.sh at install time. The upstream LICENSE is preserved alongside the artifacts.

PluginUpstreamTagLicense
BRAT (obsidian42-brat)TfTHacker/obsidian42-brat2.0.4MIT

Updates to BRAT itself flow through scripts/refresh-vendored-plugins.sh plus a workdesk-os release. Updates to plugins installed via BRAT flow automatically through BRAT — operators get new releases on next Obsidian launch without re-installing.

Suggested opt-in plugins

Plugins previously bundled in WorkDesk OS that operators may want to install via BRAT after first launch (use BRAT's "Add a beta plugin" command and paste the GitHub repo):

License

MIT. Fork it, ship it, make it yours.

The bundled BRAT plugin retains its own license. See vendor/plugins/obsidian42-brat/LICENSE and vendor/plugins/obsidian42-brat/UPSTREAM.md.

Source

Plan: BenaliHQ/workdesk-os-internal/plans/workdesk-os-v1.md. Codex variant: BenaliHQ/workdesk-os-codex.

Ver o original no GitHub

Bom para

Relacionados