Pltr Cli

# pltr-cli: Palantir Foundry CLI

This skill helps you use the pltr-cli to interact with Palantir Foundry effectively.

## Compatibility

- **Skill version**: 1.1.0
- **pltr-cli version**: 0.12.0+
- **Python**: 3.9, 3.10, 3.11, 3.12
- **Dependencies**: foundry-platform-sdk >= 1.69.0

## Overview

pltr-cli is a comprehensive CLI with 100+ commands for:
- **Dataset operations**: Get info, list files, download files, manage branches and transactions
- **SQL queries**: Execute queries, export results, manage async queries
- **Ontology**: List ontologies, object types, objects, execute actions and queries
- **Orchestration**: Manage builds, jobs, and schedules
- **Filesystem**: Folders, spaces, projects, resources
- **Admin**: User, group, role management
- **Connectivity**: External connections and data imports
- **MediaSets**: Media file management
- **Language Models**: Interact with Anthropic Claude models and OpenAI embeddings
- **Streams**: Create and manage streaming datasets, publish real-time data
- **Functions**: Execute queries and inspect value types
- **AIP Agents**: Manage AI agents, sessions, and versions
- **Models**: ML model registry for model and version management

## Critical Concepts

### RID-Based API
The Foundry API is **RID-based** (Resource Identifier). Most commands require RIDs:
- **Datasets**: `ri.foundry.main.dataset.{uuid}`
- **Folders**: `ri.compass.main.folder.{uuid}` (root: `ri.compass.main.folder.0`)
- **Builds**: `ri.orchestration.main.build.{uuid}`
- **Schedules**: `ri.orchestration.main.schedule.{uuid}`
- **Ontologies**: `ri.ontology.main.ontology.{uuid}`

Users must know RIDs in advance (from Foundry web UI or previous API calls).

### Authentication
Before using any command, ensure authentication is configured:
```bash
# Configure interactively
pltr configure configure

# Or use environment variables
export FOUNDRY_TOKEN="your-token"
export FOUNDRY_HOST="foundry.company.com"

# Verify connection
pltr verify
```

### Output Formats...

# pltr-cli Claude Code Skill

This directory contains a Claude Code skill for working with Palantir Foundry using the pltr-cli.

## Installation

### Use Within This Repository

The skill is automatically available when using Claude Code in this repository.

### Install Globally

```bash
cp -r claude_skill ~/.claude/skills/pltr
```

## Structure

```
claude_skill/
├── SKILL.md                    # Main skill definition
├── reference/                  # Command references (loaded on-demand)
│   ├── quick-start.md         # Setup and authentication
│   ├── dataset-commands.md    # Dataset operations
│   ├── sql-commands.md        # SQL queries
│   ├── orchestration-commands.md  # Builds, jobs, schedules
│   ├── ontology-commands.md   # Ontology operations
│   ├── admin-commands.md      # User/group management
│   ├── filesystem-commands.md # Folders, spaces, projects
│   ├── connectivity-commands.md   # Connections, imports
│   └── mediasets-commands.md  # Media operations
└── workflows/                  # Common patterns
    ├── data-analysis.md       # Analysis workflows
    ├── data-pipeline.md       # ETL and pipelines
    └── permission-management.md   # Access control
```

## Usage

Ask Claude Code questions about Foundry tasks:

- "How do I query a dataset?"
- "Help me set up a daily build schedule"
- "Grant viewer access to john.doe on my dataset"
- "Execute SQL query to count rows"

Claude will automatically use this skill to provide accurate guidance.

## Documentation

See [docs/user-guide/claude-skill.md](../docs/user-guide/claude-skill.md) for full documentation.