Installation & SetupCore ConceptsCLI ReferenceCodebase MappingPII ProtectionMCP IntegrationMCP Setup GuideAPI Reference

Getting Started

Apart Intelligence captures your organization's decisions, processes, policies, and architecture as interconnected nodes in a knowledge graph. AI writes. AI reads. Humans curate. The graph grows as agents work.

Install

npm install -g @apart-tech/apart-intelligence

Initialize

Run the setup wizard to configure your knowledge graph and connect to Apart Intelligence cloud.

ai init

The wizard creates your organization, generates an API key, seeds the domain taxonomy, and saves your configuration to .apart.yaml.

If you already have an API key:

ai login         # authenticate with existing key
ai whoami        # verify connection

Capture Your First Node

ai add "Our API rate limit is 1000 req/min per client"

This creates a knowledge node with the content you provided. The CLI auto-classifies the type, embeds the content for semantic search, and stores it as a draft.

You can be more specific:

ai add "All PRs require two approvals" --type policy --title "PR Approval Policy"
ai add "Deploy every Tuesday at 2pm" --type process --domain delivery

Search

Search combines semantic (meaning-based) and keyword matching. You don't need to remember exact words — just describe what you're looking for.

ai search "deployment process"
ai search "security requirements" --type policy
ai search "api" --limit 5 --include-drafts

Approve Nodes

Nodes start as draft and are hidden from search by default. Approve them to make them searchable:

ai drafts                    # list pending nodes
ai status <id> approved      # approve for search

Tip

All commands accept short ID prefixes (like git). If search shows f69b06e0, you can use ai get f69b06e0 instead of the full UUID.

Get Context

Context assembly pulls related knowledge via search + graph traversal — useful for LLM prompts or reports:

ai context "incident response" --depth 2 --max-nodes 50
ai context "deployment pipeline" -f markdown

Connect to AI Tools

Apart Intelligence works with Claude, Cursor, and any MCP-compatible tool via the MCP server. See the MCP Integration guide.

# Add to your Claude Desktop or Cursor MCP config:
{
  "mcpServers": {
    "apart-intelligence": {
      "command": "npx",
      "args": ["-y", "@apart-tech/intelligence-mcp"],
      "env": {
        "APART_API_URL": "https://api.intelligence.apart.tech",
        "APART_API_KEY": "apart_your-api-key"
      }
    }
  }
}

Next Steps