What is ARK CLI?
An explanation of ARK CLI's purpose, the ARK research project, and how AI agents explore knowledge graphs.
ARK CLI is the command-line companion to the ARK (Adaptive Retriever of Knowledge) project. It provides a terminal interface for conversational exploration of biomedical knowledge graphs using AI agents.
The ARK Project
ARK is a research project from the Zitnik Lab at Harvard Medical School. It studies how AI agents can autonomously reason over large-scale biomedical knowledge graphs to answer complex questions, navigating millions of nodes and edges to find relevant information without manual query construction.
Read the ARK paper: Autonomous Knowledge Graph Exploration with Adaptive Breadth-Depth Retrieval (arXiv:2601.13969).
How It Works
When you start ARK CLI, you select a knowledge graph to explore. The system creates an AI agent (powered by Anthropic Claude) that has access to a set of graph traversal tools. You ask questions in natural language; the agent decides which tools to invoke, queries the graph, and synthesizes an answer.
- You select a knowledge graph (e.g., PrimeKG for precision medicine).
- You type a question in natural language.
- The AI agent analyzes your question and decides which graph tools to use.
- The agent executes tool calls: searching nodes, traversing edges, and inspecting properties.
- The agent synthesizes the results into a natural language answer with citations.
- You ask follow-up questions, and the agent maintains conversation context.
Why a CLI?
A terminal interface provides a focused, distraction-free environment for exploratory research. ARK CLI uses a React-based terminal UI (@ai-tui/core) that renders rich, formatted output directly in your terminal, including structured tool call results, markdown, and syntax highlighting.
For a deeper look at the architecture, see How It Works.