// 1. Detect available projects
mcp__knowns__detect_projects({})

// 2. Set the active project
mcp__knowns__set_project({ "projectRoot": "/path/to/project" })

// 3. Verify project is set
mcp__knowns__get_current_project({})

{
  "command": "npx",
  "args": ["-y", "knowns", "mcp"]
}

knowns mcp setup

{
  "mcpServers": {
    "knowns": {
      "command": "npx",
      "args": ["-y", "knowns", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "knowns": {
      "command": "npx",
      "args": ["-y", "knowns", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "knowns": {
      "command": "npx",
      "args": ["-y", "knowns", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "knowns": {
      "command": "npx",
      "args": ["-y", "knowns", "mcp"]
    }
  }
}

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "knowns",
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "knowns", "mcp"]
        }
      }
    ]
  }
}

# Auto-generate MCP config
knowns mcp setup

# Only create project-level .mcp.json
knowns mcp setup --project

# Only register globally with Claude Code
knowns mcp setup --global

You: "Start working on task 42"

Claude: [Reads task via MCP]
"I see task #42 'Add user authentication' with these acceptance criteria:

- User can login with email/password
- JWT token is returned on success
- Invalid credentials return 401

The description references @doc/patterns/auth. Let me check that..."

[Fetches patterns/auth.md via MCP]

"Got it! The auth pattern uses JWT with 15-minute access tokens and
7-day refresh tokens. I'll implement following this pattern.

Starting timer and beginning implementation..."

[Starts time tracking via MCP]

# Sync with full embedded MCP guidelines (default)
knowns agents sync --type mcp

# Sync with minimal instruction only
knowns agents sync --type mcp --minimal

# Sync all files
knowns agents sync --type mcp --all

mcp__knowns__get_guideline({})                    # Full guidelines (all sections)
mcp__knowns__get_guideline({ type: "unified" })   # Same as above

// Step 1: Use smart mode (recommended) - auto-handles size
{ "path": "readme", "smart": true }
// Small doc → returns full content
// Large doc → returns stats + TOC

// Step 2: Read specific section (if large)
{ "path": "readme", "section": "2" }

// Edit specific section only
{ "path": "readme", "section": "2", "content": "New content" }

// 0. Session init (required for global MCP configs)
mcp__knowns__detect_projects({})
mcp__knowns__set_project({ "projectRoot": "/path/to/project" })

// 1. Get task
mcp__knowns__get_task({ "taskId": "abc123" })

// 2. Take task
mcp__knowns__update_task({
  "taskId": "abc123",
  "status": "in-progress",
  "assignee": "@me"
})

// 3. Start timer
mcp__knowns__start_time({ "taskId": "abc123" })

// 4. Add acceptance criteria
mcp__knowns__update_task({
  "taskId": "abc123",
  "addAc": ["User can login"]
})

// 5. Set implementation plan
mcp__knowns__update_task({
  "taskId": "abc123",
  "plan": "1. Research\n2. Implement\n3. Test"
})

// 6. Check AC after completing
mcp__knowns__update_task({
  "taskId": "abc123",
  "checkAc": [1]
})

// 7. Append progress notes
mcp__knowns__update_task({
  "taskId": "abc123",
  "appendNotes": "✓ Completed: login feature"
})

// 8. Stop timer
mcp__knowns__stop_time({ "taskId": "abc123" })

// 9. Mark done
mcp__knowns__update_task({
  "taskId": "abc123",
  "status": "done"
})

# Check project is initialized
knowns init

# For global configs, use session init
mcp__knowns__detect_projects({})
mcp__knowns__set_project({ "projectRoot": "/path" })

knowns init          # ensure project initialized
knowns mcp --stdio   # start MCP server

knowns task pdyd2e --plain | pbcopy
knowns doc "auth-pattern" --smart --plain