dsh-knowz

Readme

# Knowz

Knowz AI plugin for **DeepSeek Harness**. Product name: **Knowz**. Publisher: **Knowz AI**.

Connects agents to hosted Knowz vaults over MCP. This plugin is **knowledge only**. For TDD / quality gates, install **[KnowzCode](https://github.com/knowz-io/deepseek-knowzcode-plugin)** separately — do not merge the two.

Official discovery is the GitHub topic [dsh-plugin](https://github.com/topics/dsh-plugin). There is **no DeepSeek store**.

## Install

```sh
dsh plugin --profile web add github:knowz-io/deepseek-knowz-plugin
```

Then create a `ukz_` key at [https://app.knowz.io/settings/api-keys](https://app.knowz.io/settings/api-keys), set `KNOWZ_API_KEY` in the environment or `$DSH_HOME/.credentials.yaml`, and restart `dsh web`.

```sh
export KNOWZ_API_KEY=ukz_…
```

Do not paste API keys in chat. Do not run `/knowz register` on an existing Knowz account — that creates a **new** account. `/knowz register` is not the existing-user login path.

Package id: `dsh-knowz`.

## Auth

The shipped MCP row interpolates `process.env.KNOWZ_API_KEY` into `Authorization: Bearer`. Export + restart is the path that attaches the header. `$DSH_HOME/.credentials.yaml` is the DSH-managed store; it is not automatically materialized into `process.env`.

OAuth is not in this first slice.

Personal + business tenants: two MCP rows with unique `serverName` values and two env refs. Same URL `https://mcp.knowz.io/mcp` is fine. Duplicate `serverName` fails at load. See [MULTI-ACCOUNT.md](./MULTI-ACCOUNT.md).

## MCP

Official client: `@deepseek-ai/dsh-mcp-client`. Hosted endpoint: `https://mcp.knowz.io/mcp` (HTTP JSON-RPC / streamable HTTP).

No secrets, `CLIENT_ID`, literal bearer token, or `x-api-key` in this package.

After the key is set, ask the agent to run the `knowz-setup` skill to map vaults.

## Skills

`knowz-ask`, `knowz-save`, `knowz-search`, `knowz-browse`, `knowz-amend`, `knowz-setup`, `knowz-status`, `knowz-flush`, `knowz-auto`

DeepSeek Harness does not ship Cursor-style slash-command files. Ask the agent to run the skill by name.

## License

MIT — publisher **Knowz AI**. Homepage: [https://knowz.io](https://knowz.io)