feat: /knowledge to extract knowledge files

[paralin]

Adds a command /knowledge which creates a sub-agent to take any new "knowledge" in the session and format it neatly into markdown docs in ./.opencode/knowledge/

This is particularly useful both for human-readable documentation for getting familiarized with a codebase, and for providing an extended version of AGENTS.md which does not pollute the context.

A follow-on commit adds a system to automatically load files from the knowledge directory according to topics mentioned in the conversation.

Try running /knowledge to create the sub-agent.

[edlsh]

Hey @paralin, the format CI is set up to auto-push formatting fixes, but this doesn't work for PRs from forks (the GitHub token can't push to external repos).

You'll need to run bun run prettier --ignore-unknown --write . locally and push the formatted changes yourself.

[edlsh]

@paralin Don't worry too much about the format CI - it fails on fork PRs because it can't push back to external repos. Once a maintainer approves and merges to dev, the auto-formatting will run with proper permissions and fix it up.

[edlsh]

If you really wanted all green lights, then:

# 1. Generate SDK
bun ./packages/sdk/js/script/build.ts

# 2. Format everything (including generated SDK)
bun run prettier --ignore-unknown --write .

# 3. Commit and push
git add -A && git commit --amend && git push -f

The key is formatting after SDK generation so the generated files are also formatted.

[Raviguntakala]

commit adds a system to automatically load files from the knowledge directory according to topics mentioned in the conversation.

Try running /knowledge to create the sub-agent.

Sdk ci format and format ci always clash with each other, so you will never see both turn green. So chill, even if the ci fails they don’t bother much. It will still get merged

[paralin]

Working now and this PR is as minimal as possible to add the feature. I'm using it a lot in my projects.

In opencode.jsonc:

  "agent": {
    "knowledge-extractor": {
      // "model": "github-copilot/claude-opus-4-5",
      "model": "github-copilot/oswe-vscode-prime",
    },
  },