open-index/open-npm huggingface dataset:
npm package: @know-graph/cli
Description: CLI tool for KnowGraph
Latest version: 0.4.2

# @know-graph/cli

Command-line interface for [KnowGraph](https://github.com/idosams/know-know) — make your codebase AI-navigable.

## Installation

```bash
npm install -g @know-graph/cli
# or
npx @know-graph/cli <command>
```

## Commands

| Command | Description |
|---------|-------------|
| `knowgraph init` | Initialize KnowGraph in a project (creates `.knowgraph.yml`) |
| `knowgraph parse <path>` | Parse annotated files and output extracted entities |
| `knowgraph index [path]` | Build the SQLite index from annotated source files |
| `knowgraph query <term>` | Search the index with full-text search and filters |
| `knowgraph serve` | Start the MCP server for AI assistant integration |

## Quick Start

```bash
# Initialize in your project
knowgraph init

# Add @knowgraph annotations to your code, then index
knowgraph index ./src

# Search your codebase
knowgraph query "authentication"
knowgraph query --owner "auth-team"
knowgraph query --tags "security,auth"

# Start MCP server for Claude integration
knowgraph serve
```

## Documentation

See the [main repository](https://github.com/idosams/know-know) for full documentation, annotation format, and examples.

## License

MIT
npm package: @know-graph/core
Description: Core library for KnowGraph - code knowledge graph
Latest version: 0.4.2

# @know-graph/core

Core library for [KnowGraph](https://github.com/idosams/know-know) — parsers, indexer, query engine, and type definitions.

## Installation

```bash
npm install @know-graph/core
```

## What's Included

- **Parsers** — Language-specific parsers for Python, TypeScript/JavaScript, and a generic comment parser
- **Metadata Extractor** — Extracts and validates `@knowgraph` YAML metadata from code comments
- **Indexer** — SQLite-backed indexer with FTS5 full-text search
- **Query Engine** — Search and filter indexed entities by text, owner, tags, type, and status
- **Types** — Zod schemas and TypeScript types for entities, metadata, and manifests

## Usage

```typescript
import {
  createDefaultRegistry,
  createIndexer,
  createQueryEngine,
} from '@know-graph/core';

// Parse files
const registry = createDefaultRegistry();
const results = registry.parse(fileContent, 'src/auth.ts');

// Index a project
const indexer = createIndexer({ dbPath: '.knowgraph/knowgraph.db' });
await indexer.indexDirectory('./src');

// Query the index
const engine = createQueryEngine('.knowgraph/knowgraph.db');
const entities = engine.search('authentication', { owner: 'auth-team' });
```

## Documentation

See the [main repository](https://github.com/idosams/know-know) for full documentation, annotation format, and examples.

## License

MIT
npm package: @know-graph/mcp-server
Description: MCP server for KnowGraph
Latest version: 0.4.2

# @know-graph/mcp-server

MCP (Model Context Protocol) server for [KnowGraph](https://github.com/idosams/know-know) — connect your code knowledge graph to AI assistants.

## Installation

```bash
npm install -g @know-graph/cli
# The MCP server is included with the CLI
```

Or install standalone:

```bash
npm install @know-graph/mcp-server
```

## Usage with Claude Desktop

Add to your Claude Desktop configuration (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "knowgraph": {
      "command": "knowgraph",
      "args": ["serve", "--db", "/path/to/project/.knowgraph/knowgraph.db"]
    }
  }
}
```

## MCP Tools

| Tool | Description |
|------|-------------|
| `search_code` | Full-text search across entity names, descriptions, and tags |
| `find_by_owner` | Find all entities owned by a specific team or person |
| `find_by_business_goal` | Discover entities related to a business objective |
| `get_dependencies` | Map dependencies for an entity (services, APIs, databases) |
| `get_entity_details` | Get complete metadata for a specific entity |
| `get_external_knowledge` | Find linked external resources (Notion, Jira, dashboards) |
| `graph_overview` | Get high-level statistics about the indexed codebase |

## Documentation

See the [main repository](https://github.com/idosams/know-know) for full documentation, annotation format, and examples.

## License

MIT
npm package: @know-your-ai/cli
Description: Know Your AI CLI — Run evaluations, check connectivity, and manage AI security testing from the command line
Author: HydroxAI
Latest version: 0.1.7

# @know-your-ai/cli

Command-line interface for [Know Your AI](https://knowyourai.hydrox.ai) — AI Security Testing & Evaluation.

## Installation

```bash
curl -fsSL https://knowyourai.hydrox.ai/cli/install.sh | bash
```

Or install directly via npm:

```bash
npm install -g @know-your-ai/cli
```

## Quick Start

```bash
# 1. Set your DSN (from Know Your AI dashboard → Settings → API Keys)
export KNOW_YOUR_AI_DSN="https://kya_xxx:da2-xxx@host/product_id"

# 2. Verify your setup
know-your-ai doctor

# 3. Run an evaluation
know-your-ai evaluate <evaluation-id>
```

## Commands

### `know-your-ai doctor`

Validates your DSN configuration and tests connectivity to the Know Your AI API.

```bash
$ know-your-ai doctor

Know Your AI CLI
Checking your configuration and connectivity...

Results
────────────────────────────────────────────────────────────
  ✔ KNOW_YOUR_AI_DSN
    Environment variable is set
  ✔ DSN Format
    Host: xxx.appsync-api.us-west-2.amazonaws.com | Product: prod_xxx
  ✔ API Key
    Valid KYA key: kya_xxxx...
  ✔ API Connection
    Connected successfully. Product: My AI Product
  ✔ Evaluations
    Found 3 evaluations in this product
  ✔ Datasets
    Found 5 datasets in this product
────────────────────────────────────────────────────────────
✔ All checks passed! You're ready to run evaluations.
```

### `know-your-ai evaluate <evaluation-id>`

Triggers an evaluation run and displays real-time progress and results.

```bash
$ know-your-ai evaluate eval-abc-123

know-your-ai evaluate
Evaluation ID: eval-abc-123

ℹ Evaluation: Jailbreak Resistance Test
  Judge model: gemini-2.0-flash
  Threshold:   0.8

ℹ Starting evaluation run...

  running      [████████████░░░░░░░░] 12/20 tests (45s)

Results
──────────────────────────────────────────────────
  Total tests:     20
  Secure:          18
  Vulnerable:      2
  Score:           90.0%
  Duration:        67.3s
  Run ID:          run-xyz-789
──────────────────────────────────────────────────
⚠ 2 out of 20 tests found vulnerabilities.
ℹ Review detailed results in the Know Your AI dashboard.
```

**Options:**

| Flag | Description | Default |
|------|-------------|---------|
| `--max-prompts <n>` | Maximum prompts per dataset | 3 |
| `--timeout <seconds>` | Maximum wait time in seconds | 600 |
| `--debug` | Enable debug logging | false |

### `know-your-ai help`

Show help and usage information.

### `know-your-ai version`

Show the installed version.

## Short Alias

You can use `kya` as a shorthand:

```bash
kya doctor
kya evaluate eval-abc-123
```

## Environment Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `KNOW_YOUR_AI_DSN` | DSN from Know Your AI dashboard (Settings → API Keys) | Yes |

## License

MIT — [HydroxAI](https://hydrox.ai)
npm package: @know-your-ai/core
Description: Core library for Know Your AI SDK - AI model interception and monitoring
Author: HydroxAI
Latest version: 0.1.0

# @know-your-ai/core

Core library for the Know Your AI SDK. This package provides the foundational components for AI monitoring and instrumentation.

## Installation

This package is typically used through `@know-your-ai/node`. Direct installation is only needed for advanced use cases.

```bash
npm install @know-your-ai/core
```

## Quick Start

Initialize the SDK with your API key obtained from the Know Your AI dashboard:

```typescript
import * as KnowYourAI from '@know-your-ai/node';

KnowYourAI.init({
  apiKey: 'kya_your_api_key_here',
  integrations: [
    KnowYourAI.googleGenAIIntegration(),
  ],
});

// Your AI code will now be automatically monitored
```

## Getting Your API Key

1. Go to the Know Your AI dashboard
2. Navigate to your Workspace > Products
3. Select or create a Product
4. Go to Settings > API Keys
5. Create a new API key
6. Copy the key (it will only be shown once!)

## Configuration Options

```typescript
KnowYourAI.init({
  // Required: Your API key from Know Your AI dashboard
  apiKey: 'kya_...',

  // Optional: Custom endpoint (defaults to Know Your AI backend)
  endpoint: 'https://api.knowyourai.dev/sdk/events',

  // Optional: Environment identifier
  environment: 'production', // 'development', 'staging', etc.

  // Optional: Control what data is captured
  recordInputs: true,  // Capture input messages
  recordOutputs: true, // Capture AI responses

  // Optional: Sampling rate (0.0 to 1.0)
  sampleRate: 1.0,

  // Optional: Enable debug logging
  debug: false,

  // Optional: Batch settings
  batchSize: 10,      // Events to batch before sending
  flushInterval: 5000, // Max time (ms) to wait before flushing

  // Required: Integrations to use
  integrations: [
    KnowYourAI.googleGenAIIntegration({
      recordInputs: true,
      recordOutputs: true,
    }),
  ],
});
```

## What's Included

- **Client** - Core client for managing integrations and capturing data
- **Integrations** - Plugin system for adding AI provider support
- **Transports** - Data transport implementations (HTTP, console, Know Your AI backend)
- **Types** - TypeScript type definitions
- **Utilities** - Helper functions and debug utilities

## Available Transports

### Know Your AI Transport (Default)
Automatically configured when using `apiKey` option.

### HTTP Transport
For custom endpoints:
```typescript
import { createHttpTransport } from '@know-your-ai/core';

const transport = createHttpTransport({
  endpoint: 'https://your-custom-endpoint.com/events',
  apiKey: 'your-custom-api-key',
});
```

### Console Transport (Debugging)
```typescript
import { createConsoleTransport } from '@know-your-ai/core';

const transport = createConsoleTransport();
```

## License

MIT