Useful memory.
On your terms.

01 / Get the client

Versioned downloads

node --input-type=module -e "import fs from 'node:fs'; import {createHash} from 'node:crypto'; const actual=createHash('sha256').update(fs.readFileSync(process.argv[1])).digest('hex'); if(actual!==process.argv[2]){console.error('SHA-256 mismatch. Do not install.');process.exit(1)} console.log('SHA-256 matches.');" 'woodwide-0.1.0-node.tar.gz' '0fceecedf6e30b2c565c7cb93325d3ca689417813d26c179870174bcedf69b4d'

02 / Start privately

Start account-free

Complete the release install guide first. Once woodwide is available in your terminal, initialize private memory without hooks or extraction:

woodwide init --local --no-install --extract false
woodwide memory

This local initialization does not create an account, install hooks or enable extraction. Sharing and benchmark telemetry are off. An empty memory list is expected before your first successful extraction.

node --version
npm install
npm run build
node packages/cli/dist/main.js init --local --no-install --extract false
node packages/cli/dist/main.js memory

Enable extraction deliberately

For Codex sessions, automatic extraction uses your authenticated Codex CLI. For other sessions it uses the Anthropic API when configured, otherwise Claude CLI; automatic API failure may fall back to Claude CLI. OpenCode and Gemini backfill do not necessarily reuse the session’s original provider.

woodwide config set extraction_enabled true
woodwide backfill --harness codex --days 14 --limit 5
woodwide memory

Run backfill in an interactive terminal and review its confirmation before proceeding. Use --harness claude-code, opencode or gemini-cli for the corresponding session source. Provider authentication and the relevant CLI or optional API dependency must already be available.

woodwide memory "repeated build failure"
woodwide memory --export ./woodwide-notes

The CLI’s memory --show option reads a local ID from the listing. Canonical JSON and readable Markdown live under ~/.woodwide/playbooks/, or your configured WOODWIDE_HOME. Exported copies do not update themselves after a redaction-rule change.

03 / Connect an agent

Connect your coding agent

After local setup, install only the integration you intend to use. Hook commands refer to the client location: keep it stable and reinstall/review changed definitions after an upgrade.

Verified on 8 September 2026: Codex CLI 0.153.4 on macOS and Ubuntu, local JSON/Markdown retention, shared correction recall in both directions, secret-guard checks and real elapsed-time offer expiry. Node 22.5 launcher compatibility was also tested. These are controlled synthetic tests, not a benchmark of real-world fix quality.

woodwide install codex
woodwide doctor

woodwide install claude-code

woodwide install opencode

woodwide mcp

Suggestions that keep you moving

Manual mode is the default: one optional playbook offer, no pause in agent work and no reply required. An unanswered offer expires after 60 seconds unless you interact with that specific suggestion before it expires. Unrelated chat or tool activity does not extend it; silence is not acceptance.

Asking to show an offer keeps it available for that workflow. Viewing is not acceptance and does not mark the task successful.

Prefer fewer confirmations?

Enable auto_consume to accept eligible, screened guidance in the current task without another Woodwide confirmation. It is off by default, and your choice is saved until you change it.

woodwide config set auto_consume true

woodwide config set auto_consume false

Auto-consume does not launch a headless agent or subagent, or grant permission to use tools, make destructive changes or upload data. Offer expiry leaves secret-guard and correction-capture settings unchanged. Read the guidance boundaries.

04 / Optional network

Add shared lessons when you choose

Local memory works without signing in. When available, Continue with Google opens the Woodwide account service for sign-up and account management. Keep API keys private: do not paste them into this website or put them in a URL.

Sign in with Google and create a CLI key on the account page. Connect it in your terminal using the hidden prompt below. Login enables network recall; publishing and telemetry keep their own settings and start off.

woodwide login --no-browser

Paste the key only into that hidden prompt. Network recall sends a task/error query and stack context. Before publishing, review the proposed generalized playbook and the processing and retention boundaries. Sharing is never required for free-beta corrections or checks.

05 / Keep control

Separate switches. Readable copies.

woodwide network off

This stops Woodwide server requests. Reading existing local summaries stays available. Model-provider extraction is controlled separately.

woodwide config set extraction_enabled false
woodwide config set telemetry false

For a connected account, turning sharing off stops publishing; it may send the updated preference to the configured server. Telemetry is a separate control.

woodwide share off

Choose review mode before publishing. The CLI’s review command can approve uploads; it is not just local reading.

woodwide config set upload_mode review

woodwide uninstall all

This removes installed settings hooks/plugins managed by that command; remove an independently installed Claude Code plugin through its own installation mechanism. It does not delete local summaries, stop manually invoked processing, erase uploads or remove downloaded client files.

Troubleshooting

woodwide doctor
woodwide status