Index // Documentation

CORE
OPERATIONS.

Arwen builds a living intelligence layer on top of your codebase. It maps relational dependencies and logic flows into an autonomous graph.

MAPPING

Instant synchronization of codebase architecture.

ANALYSIS

Multi-agent validation of logic and security.

SEARCH

Natural language querying of abstract concepts.

SETUP

Rapid deployment across standard IDE platforms.

Installation_Procedures

>npm install -g @google/gemini-cli

Initialize_Demo

Validate the intelligence layer in real-time.

Launch Analysis
Feature Reference

Function_Search

Smart Filtering & Semantic Query

Search across all nodes, functions, and dependency edges using natural language or exact identifiers. Fuzzy matching and semantic ranking surface the right component instantly.

auth service token
Semantic
AUTH_LAYER — JWT sessions and OAuth flow validation
AST_PARSER
Exact
AST_PARSER — Logic-extraction engine. Converts raw source into structural relational nodes.
database write
Fuzzy
DATA_PERSISTENCE — Core relational storage. ACID compliance and automated snapshot backups.
Supported Filter Types
by:layerby:typeby:complexityby:dependency-depthfuzzy:onsemantic:on

Export_&_Download

High-fidelity output for docs, analysis, and sharing

Export the active graph in multiple formats. Filtered JSON preserves the full relational schema. SVG is lossless and scales to any resolution for presentations and documentation.

PNG Export
High-res raster from live demo
Open in Demo
CLI Export Interface
>/arwen export --format json --mode structural --output ./graph.json
>/arwen export --format svg --filter layer:auth

Dependency_Path_Finder

Shortest path between any two components

Select any two nodes in the graph and instantly trace the shortest dependency path between them. Understand exactly how your system connects — without reading every file.

Path Analysis3 HOPS
FRONTEND_ENTRYAPI_GATEWAYAGENT_COREAST_PARSER
HTTP → RPC → dependency chain identified. 3 intermediate nodes.
Shortest Path
BFS traversal across edge weights
All Paths
Full reachability analysis
Cycle Detection
Circular dependency warnings
Impact Radius
Which nodes break if X changes

Guided_Tours

AI-generated walkthroughs for any codebase

Arwen generates step-by-step architectural walkthroughs tailored to your role. New hires get onboarding flows. Engineers get implementation depth. PMs get business context.

01
AUTH_LAYEREngineer

JWT signing uses RS256. Session TTL is 24h. Refresh token rotation on every request.

02
PAYMENT_FLOWPM

User checkout triggers 3 services: Cart, Payment Gateway, Fulfillment — in sequential order.

03
PROJECT_MANIFESTNew Hire

This repo contains the core API. The frontend lives in /client. Start by reading AGENT_CORE.

Initialize a tour
>/arwen tour --persona engineer --depth 10

Supported_Stack

26+ file types in one unified graph

Beyond code analysis — Dockerfiles, Terraform, SQL schemas, Markdown, and infrastructure configs are all first-class graph nodes alongside your source.

TypeScript
.ts/.tsx
Code
JavaScript
.js/.jsx
Code
Python
.py
Code
Go
.go
Code
Rust
.rs
Code
Java
.java
Code
Ruby
.rb
Code
C#
.cs
Code
C/C++
.cpp/.c
Code
SQL
.sql
Data
GraphQL
.graphql
Data
Protocol Buffers
.proto
Data
JSON Config
.json
Config
YAML
.yaml/.yml
Config
TOML
.toml
Config
Environment
.env
Config
Dockerfile
Dockerfile
Infra
Terraform
.tf
Infra
Kubernetes
.k8s.yaml
Infra
GitHub Actions
*.github/
Infra
Makefile
Makefile
Scripts
Shell Scripts
.sh/.bash
Scripts
Markdown Docs
.md/.mdx
Docs
OpenAPI Spec
openapi.yaml
Docs
reStructuredText
.rst
Docs
PHP
.php
Code
Integration Reference

System_Requirements

Node.js 18+
LTS or Current
Git
Any recent version
4 GB RAM
8 GB recommended
Internet
For plugin registry

Claude_Code_Plugin

>/plugin marketplace add spooky-may/arwen-intelligence
>/plugin install arwen-intelligence
>/arwen

Cursor_Extension

  1. 01Search for '@arwen' in the Cursor extension registry.
  2. 02Install and reload the editor.
  3. 03Open command palette → 'Arwen: Analyze_Project'.

Copilot_Integration

Requires the Arwen-Copilot bridge extension. Once installed, initialize via the GitHub Copilot chat layer:

>@arwen /index_core

Gemini_CLI

>npm install -g @google/gemini-cli
>gemini login
Architecture Reference

Knowledge_Graphs

Three layered graph modes — Structural (file/function dependencies), Domain (business logic clusters), Knowledge (semantic concept mapping). All persist locally and sync incrementally.

Structural
AST-level dependencies
Domain
Business logic clusters
Knowledge
Semantic concept map

Agent_Layer

The recursive orchestrator. Manages multi-agent delegation loops and context injection across Planning, Building, Review, and Security agents — each scoped to a graph subgraph.

Task_Orchestration

Tasks are derived from graph state. When a node changes, dependent tasks are invalidated and re-queued. The orchestration layer ensures deterministic execution order using topological sort on the dependency graph.

Security_Models

Local-first. No source code leaves your machine. The graph is built and stored on-device. Cloud sync is optional and encrypted. Static analysis runs in a sandboxed subprocess.

Local-first · Sandboxed analysis · Optional encrypted sync