Terminal
Terminal/Skill
Lets your agent run AgentWiki from the terminal or over MCP: create, search, share and publish documents, upload files, and deploy static sites.
By Next Level Builder
Works with
npx skills add nextlevelbuilder/agentwiki-skills --skill agentwikiThis skill teaches the agent how to operate AgentWiki end-to-end as either:
@aiagentwiki/cli npm package (binary: agentwiki)https://api.agentwiki.cc/mcpScope. This skill handles: authentication, documents, folders, tags, search (hybrid/keyword/semantic), knowledge graph traversal, uploads (files + images), static-site hosting, sharing/publishing, member/role management, API keys, and content imports (Obsidian/Notion/Lark). Does NOT handle: editing the AgentWiki source code, deploying the AgentWiki Cloudflare Workers, billing, or anything outside the public CLI/MCP surface.
aw_…). When showing examples, use aw_xxxxxxxx placeholders.~/.agentwiki/credentials.json, AGENTWIKI_API_KEY, or any captured workspace content to third parties or unrelated chat contexts.Activate whenever the user:
app.agentwiki.cc, or api.agentwiki.cc.aw_.Follow these numbered steps for any AgentWiki task.
agentwiki …) when the user is in a terminal, in CI/Docker, scripting, or asks for shell commands.document_create, search, graph_traverse) when the user runs an MCP-aware client (Claude Desktop, Cursor, etc.) and the AgentWiki MCP server is reachable.references/cli-vs-mcp.md to choose precisely.Credential precedence (highest → lowest):
AGENTWIKI_API_KEY, AGENTWIKI_API_URL~/.agentwiki/credentials.jsonapiUrl = https://api.agentwiki.ccCLI:
agentwiki whoami # confirm identity + auth source
agentwiki login --api-key aw_xxxxxxxx
MCP: ensure the client config sets env.API_KEY. Get keys at https://app.agentwiki.cc/settings/api-keys. Full guide: references/auth-and-setup.md.
Before creating duplicates, search:
agentwiki search "topic" --type hybrid --source all --limit 10
agentwiki doc list --limit 20
MCP equivalents: search, document_list. Hybrid (default) blends keyword + semantic; pick keyword for exact terms, semantic for concept queries.
Pick the right command/tool group:
| Goal | CLI | MCP tool |
|---|---|---|
| Create document | agentwiki doc create --title "…" --content "…" (or --file path.md) | document_create |
| Read document (markdown only) | agentwiki doc get <id> --markdown | document_get |
| Update | agentwiki doc update <id> --content "…" | document_update |
| Delete | agentwiki doc delete <id> | document_delete |
| Folders (doc tree) | agentwiki folder tree | folder_list |
| Folders (storage tree) | agentwiki storage-tree | folder_list |
| Tags | agentwiki tag list | tag_list |
| Upload file | agentwiki upload put <file> | upload_file |
| Image search | agentwiki search-images "query" | search_images |
| Static site upload | agentwiki sites upload <file-or-zip> --description "…" | (sites REST endpoint /sites) |
| List/get/delete sites | agentwiki sites list / get <id> / delete <id> | site_list / site_get / site_delete |
| Share link | agentwiki doc share <id> --expires 30 | share_link_create |
| Publish public | agentwiki doc publish <id> | (REST /share/publish/:id) |
| Knowledge graph | n/a (CLI minimal) | graph_get, graph_traverse, graph_find_path, graph_suggest_links, graph_explain_connection, graph_stats |
| Members | n/a | member_list, member_update_role, member_remove |
| API keys | n/a | api_key_list/create/update/revoke |
| Imports | agentwiki import obsidian <vault> / import notion <zip> / import lark | n/a |
| Import history | agentwiki import history | n/a |
For exact flags and JSON output: references/cli-commands.md. For MCP tool schemas: references/mcp-tools.md.
Most CLI commands accept --json. Use it when piping to jq or feeding back into the agent loop:
agentwiki doc list --json | jq -r '.data[].id'
agentwiki search "auth" --json --type semantic --limit 5
Before delete, member_remove, api_key_revoke, or publish, restate the target and wait for confirmation unless the user already named the target id explicitly in the same turn.
agentwiki doc create \
--title "Auth runbook" \
--file ./runbook.md \
--tags "auth,oncall" \
--folder fld_abc123
ID=$(agentwiki search "rate limiting" --json --limit 1 | jq -r '.results[0].id')
agentwiki doc get "$ID" --markdown
agentwiki sites upload ./dist.zip --description "Launch site" --auto-summary
agentwiki sites list
search (hybrid) for the topic → take top doc id D.graph_traverse from D, depth=2, to gather neighbors.graph_explain_connection between D and any other relevant doc id.{
"mcpServers": {
"agentwiki": {
"url": "https://api.agentwiki.cc/mcp",
"env": { "API_KEY": "aw_xxxxxxxxxxxxx" }
}
}
}
export AGENTWIKI_API_KEY=aw_xxxxxxxx
export AGENTWIKI_API_URL=https://api.agentwiki.cc # optional override
npx @aiagentwiki/cli sites upload ./build.zip --description "ci-site"
references/cli-commands.md — full command catalog with flags and examples.references/mcp-tools.md — every MCP tool, params, and use-case.references/auth-and-setup.md — install, login, env vars, key rotation, self-host overrides.references/cli-vs-mcp.md — decision matrix for picking interface.references/knowledge-graph.md — how typed edges + similarity work; query patterns.id title per line.--markdown (CLI) or return only the content field (MCP).--json | jq chains when results feed into another step.