# Intellyweave Cli

> Operations CLI for IntellyWeave - open-source platform for OSINT analysis, archival research, and investigative journalism

- **Type:** MCP server
- **Install:** `agentstack add mcp-vericle-intellyweave-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vericle](https://agentstack.voostack.com/s/vericle)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vericle](https://github.com/vericle)
- **Source:** https://github.com/vericle/intellyweave-cli

## Install

```sh
agentstack add mcp-vericle-intellyweave-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# IntellyWeave CLI

    

[](LICENSE)
[](https://www.npmjs.com/package/intellyweave-cli)
[](https://nodejs.org/)

**Operations backbone for [IntellyWeave](https://github.com/vericle/intellyweave)—the open-source platform for OSINT analysis, archival research, and investigative journalism. Manage Weaviate databases, migrate data, and query with AI.**

---

[Quick Start](#quick-start) | [Documentation](docs/) | [Interactive Shell](docs/guides/interactive-shell/) | [Contributing](docs/contributing/)

---

## See It In Action

Start the interactive shell and query your data with natural language:

```bash
intellyweave shell
```

```
> Please add the archive vault.fbi.gov and save it

Researching vault.fbi.gov...
FBI Records: The Vault - 6,700+ declassified documents
✓ Saved to: ./data/archive_domains_update.yaml
```

```
> Ask weaviate who was Paul Stangl and what evidences about his exfiltration to Brazil exist

Searching Weaviate collections...

Paul Stangl was an Austrian Nazi war criminal.

Evidence found:
1. Brazilian Consular Qualification Card (1952)
   - Issued: Beirut, Lebanon → Permanent admission to Brazil
2. Part of "Rattenlinie" (Rat Lines) network
   - Vatican officials facilitated escape
```

```
> /collections

{
  "collections": ["ELYSIA_CHUNKED_...", "ELYSIA_METADATA__", ...],
  "total": 7
}
```

[More examples in the Interactive Shell Guide](docs/guides/interactive-shell/)

---

## What is IntellyWeave CLI?

IntellyWeave CLI is the **operations backbone** for the [IntellyWeave](https://github.com/vericle/intellyweave) platform—an open-source tool for OSINT analysis, historical research, and investigative journalism. It provides direct access to Weaviate vector database operations, data migration tools, and an AI-powered shell for natural language queries.

Manage your data. Automate your workflows. Query with AI.

## Who Should Use This?

**IntellyWeave CLI is for teams who need to:**

- **Database Administrators** — Manage Weaviate collections, objects, and schemas without the web UI
- **DevOps Engineers** — Automate backup/restore operations in CI/CD pipelines
- **Power Users** — Script bulk operations and explore data programmatically
- **Developers** — Debug and explore IntellyWeave data with AI assistance
- **Archive Researchers** — Configure new archive sources for the Quartermaster agent

## Key Features

### Weaviate Database Management

Direct access to all Weaviate operations from the command line.

```bash
# List all collections with statistics
intellyweave weaviate collections --verbose

# Hybrid search across document chunks
intellyweave weaviate search ELYSIA_CHUNKED "Vatican escape routes"

# Browse objects with pagination
intellyweave weaviate objects ELYSIA_UPLOADED_DOCUMENTS --limit 20
```

| Command | Description |
|---------|-------------|
| `weaviate status` | Check connection health |
| `weaviate collections` | List all collections |
| `weaviate stats` | Show database statistics |
| `weaviate search` | Hybrid keyword + vector search |
| `weaviate objects` | Browse collection objects |
| `weaviate delete` | Delete collections (requires `--live`) |

[Weaviate Operations Guide](docs/guides/weaviate-operations/)

### Data Import/Export

Backup, restore, and migrate Weaviate data with JSON files.

```bash
# Export all collections to backup directory
intellyweave data export --output-dir ./backup-2026-01-06

# Preview import (dry-run by default)
intellyweave data import --input-dir ./backup

# Execute import with --live flag
intellyweave --live data import --input-dir ./backup
```

| Operation | Dry-Run | Live |
|-----------|---------|------|
| Export | Read-only (always safe) | N/A |
| Import | Shows preview | `--live` required |
| Delete | Shows what would be deleted | `--live` required |

[Data Operations Guide](docs/guides/data-operations/)

### Mutation Safety

**Safe by default.** All data-modifying operations require explicit `--live` flag.

```bash
# Preview what would happen (no changes made)
intellyweave data import
# Output: [DRY RUN] Would import 150 objects to ELYSIA_CHUNKED...

# Execute the mutation
intellyweave --live data import
# Output: Imported 150 objects to ELYSIA_CHUNKED
```

This prevents accidental data loss and enables safe exploration of commands before execution.

[Mutation Safety Guide](docs/guides/mutation-safety/)

### Interactive Shell with AI Agent

Natural language queries powered by Claude. Ask questions, get answers.

```bash
intellyweave shell
```

```
IntellyWeave v1.0.0

Type :help for commands, or ask a question.

intellyweave> How many documents are in Weaviate?

Checking collection statistics...
You have 1,234 documents across 5 collections.

intellyweave> Search for entities related to Vatican

Found 12 entities mentioning "Vatican":
1. Organization: "Vatican Secretariat" (confidence: 0.95)
2. Location: "Vatican City" (confidence: 0.92)
...
```

**Shell Features:**

| Feature | Description |
|---------|-------------|
| Natural Language | Ask questions in plain English |
| Quick Commands | `/collections`, `/stats`, `/config` |
| File Citations | `@filename.md` for AI context |
| MCP Integration | Connect to AI tool servers |
| Command History | Persistent across sessions |
| Mode Toggles | `/live`, `/json`, `/verbose` |

[Interactive Shell Guide](docs/guides/interactive-shell/)

### MCP Integration

Connect to Model Context Protocol servers for AI-driven operations. IntellyWeave CLI uses three MCP servers:

| Server | Purpose |
|--------|---------|
| **[mcp-weaviate](https://github.com/vericle/mcp-weaviate)** | 11 tools for Weaviate database operations |
| **Perplexity MCP** | Web research and AI-powered search |
| **Filesystem MCP** | Code editing and codebase search |

```bash
# Setup: Clone and configure the custom Weaviate MCP server
git clone https://github.com/vericle/mcp-weaviate.git

# See setup guide for complete instructions
```

```bash
# Verify MCP connections
intellyweave shell

# Expected output:
# Loaded MCP servers: filesystem, perplexity, weaviate
# 17 tools total
```

[Weaviate MCP Setup Guide](docs/guides/weaviate-mcp-setup/) | [MCP Integration Guide](docs/guides/mcp-integration/)

### Archive Configuration

Configure archive sources for the IntellyWeave Quartermaster agent.

```bash
# Research and add a new archive source
intellyweave archive config add https://bundesarchiv.de

# Output: Researching archive via Perplexity...
# Output: Generated YAML appended to ./data/archive_domains_update.yaml
```

This generates properly formatted YAML for the platform's `archive_domains.yaml` configuration.

---

## Quick Start

### Installation

```bash
# Install globally
npm install -g intellyweave-cli

# Or use with npx
npx intellyweave-cli --help
```

### Configuration

**1. Environment variables** — Copy `.env.example` to `.env`:

```bash
cp .env.example .env
```

Edit with your API keys. See [Environment Variables Reference](docs/reference/environment-variables.md) for all options.

**2. MCP servers** — Copy `intellyweave.config.example.json` to `intellyweave.config.json`:

```bash
cp intellyweave.config.example.json intellyweave.config.json
```

For Weaviate MCP, clone [mcp-weaviate](https://github.com/vericle/mcp-weaviate) and follow the [Weaviate MCP Setup Guide](docs/guides/weaviate-mcp-setup/).

### First Commands

```bash
# 1. Verify configuration
intellyweave config show

# 2. Check Weaviate connection
intellyweave setup

# 3. List collections
intellyweave weaviate collections

# 4. Start interactive shell
intellyweave shell
```

[Getting Started Guide](docs/getting-started/)

---

## Documentation

### Getting Started

| Guide | Description |
|-------|-------------|
| [Installation](docs/getting-started/installation.md) | Setup and configuration |
| [Quick Start](docs/getting-started/) | First steps with the CLI |

### Feature Guides

| Guide | Description |
|-------|-------------|
| [Interactive Shell](docs/guides/interactive-shell/) | AI-powered shell with quick commands |
| [Mutation Safety](docs/guides/mutation-safety/) | Safe-by-default operation model |
| [Weaviate MCP Setup](docs/guides/weaviate-mcp-setup/) | Configure custom Weaviate MCP server |
| [MCP Integration](docs/guides/mcp-integration/) | Model Context Protocol setup |
| [Weaviate Operations](docs/guides/weaviate-operations/) | Database management |
| [Data Operations](docs/guides/data-operations/) | Import, export, migration |

### Reference

| Document | Description |
|----------|-------------|
| [CLI Commands](docs/reference/cli-commands.md) | Complete command reference |
| [Global Options](docs/reference/global-options.md) | Flags available on all commands |
| [Environment Variables](docs/reference/environment-variables.md) | Configuration options |
| [Architecture](docs/architecture/) | System design |

### Contributing

| Document | Description |
|----------|-------------|
| [Development Setup](docs/contributing/development-setup.md) | Local development |
| [Code Standards](docs/contributing/code-standards.md) | TypeScript patterns |
| [Testing](docs/contributing/testing.md) | Test framework and philosophy |
| [Publishing](docs/contributing/publishing.md) | npm release process |

---

## Command Reference

### Global Options

| Flag | Description |
|------|-------------|
| `--live` | Enable mutations (required for data changes) |
| `--json` | Output in JSON format |
| `--quiet` | Suppress info-level output |
| `--verbose` | Enable debug logging |
| `--no-banner` | Hide startup banner |

### Common Commands

```bash
# Configuration
intellyweave setup                    # Run setup wizard
intellyweave config show              # Display configuration

# Weaviate Operations
intellyweave weaviate status          # Check connection
intellyweave weaviate collections     # List collections
intellyweave weaviate stats           # Show statistics
intellyweave weaviate search  "query"  # Hybrid search

# Data Operations
intellyweave data export              # Export to JSON
intellyweave --live data import       # Import from JSON
intellyweave --live data delete       # Delete collections

# Interactive
intellyweave shell                    # Start AI shell
intellyweave mcp --check              # Verify MCP servers
```

[Full Command Reference](docs/reference/cli-commands.md)

---

## Technical Stack

| Component | Technology |
|-----------|------------|
| **Language** | TypeScript 5.7+ (ESM) |
| **CLI Framework** | Commander.js 12.x |
| **Database Client** | weaviate-client 3.x |
| **AI Integration** | Vercel AI SDK + Anthropic Claude |
| **MCP Protocol** | @modelcontextprotocol/sdk 1.x |
| **Linting** | Biome 2.x |
| **Testing** | AVA 6.x + c8 coverage |

---

## Relationship to IntellyWeave Platform

IntellyWeave CLI is the **management layer** for the [IntellyWeave OSINT platform](https://github.com/vericle/intellyweave):

```
┌─────────────────────────────────────────────────────────────┐
│              IntellyWeave Platform (Web UI)                  │
│  Entity Extraction • Geospatial Maps • Network Analysis      │
│  Archive Research • Courthouse Debate • Intelligence Agent   │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    Weaviate Vector DB                        │
│  ELYSIA_UPLOADED_DOCUMENTS • ELYSIA_CHUNKED_* • Metadata     │
└─────────────────────────────────────────────────────────────┘
                              ▲
                              │
┌─────────────────────────────────────────────────────────────┐
│              IntellyWeave CLI (This Tool)                    │
│  Database Ops • Data Migration • MCP Tools • AI Shell        │
└─────────────────────────────────────────────────────────────┘
```

| Platform Feature | CLI Support |
|------------------|-------------|
| Document collections | `weaviate collections`, `weaviate objects` |
| Entity metadata | `weaviate search` (hybrid search) |
| Data backup | `data export` |
| Data migration | `data export` → `data import` |
| Archive sources | `archive config add` |
| AI queries | Interactive shell with Claude |

---

## Support

- **Issues**: [GitHub Issues](https://github.com/vericle/intellyweave-cli/issues)
- **Documentation**: [docs/](docs/)
- **Platform**: [IntellyWeave](https://github.com/vericle/intellyweave)

## Contributing

We welcome contributions! See the [Contributing Guide](docs/contributing/) for development setup, code standards, and testing.

For AI coding assistants, see [AGENTS.md](AGENTS.md) for comprehensive technical documentation.

---

## License

MIT License — See [LICENSE](LICENSE) for details.

---

**IntellyWeave CLI** — Operations backbone for intelligence analysis.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vericle](https://github.com/vericle)
- **Source:** [vericle/intellyweave-cli](https://github.com/vericle/intellyweave-cli)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-vericle-intellyweave-cli
- Seller: https://agentstack.voostack.com/s/vericle
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.