Gitizi CLI (izi)

The official command-line interface for gitizi.com - manage your AI prompts like a pro!

Features

• Authentication - Secure token-based authentication with gitizi.com
• Search Prompts - Find prompts from the community
• Create Prompts - Create prompts from markdown files with frontmatter
• Push Prompts - Upload and update prompts to gitizi.com
• Clone Prompts - Download existing prompts to edit locally
• Colorful Output - Beautiful terminal experience with your friendly cat mascot

Installation

npm install -g gitizi-cli

Or use directly with npx:

npx gitizi-cli <command>

Quick Start

1. Authenticate

izi auth

Or provide token directly:

izi auth --token YOUR_API_TOKEN

Get your API token from: https://gitizi.com/settings/tokens

2. Search for Prompts

izi search "code review"
izi search "typescript" --limit 20

3. Clone an Existing Prompt

izi clone abc123 -o my-prompt.md

4. Create a New Prompt

Create a markdown file with frontmatter:

---
name: My Awesome Prompt
description: A prompt that does amazing things
tags: [coding, typescript, assistant]
---

You are an expert TypeScript developer...

Then validate it:

izi create my-prompt.md

5. Push Your Prompt

izi push my-prompt.md

Update an existing prompt:

izi push my-prompt.md --id abc123

Commands

izi auth [options]

Authenticate with gitizi.com

Options:

• -t, --token <token> - API token

izi search <query> [options]

Search for prompts on gitizi.com

Arguments:

• query - Search query

Options:

• -l, --limit <number> - Limit results (default: 10)

izi create <file> [options]

Create a new prompt from markdown file

Arguments:

• file - Markdown file path

Options:

• -n, --name <name> - Prompt name
• -d, --description <desc> - Prompt description
• --tags <tags> - Comma-separated tags

izi push <file> [options]

Push a prompt to gitizi.com

Arguments:

• file - Markdown file path

Options:

• --id <id> - Prompt ID (for updates)

izi clone <prompt-id> [options]

Clone an existing prompt

Arguments:

• prompt-id - Prompt ID to clone

Options:

• -o, --output <path> - Output file path (default: ./prompt.md)

Prompt Format

Prompts should be markdown files with YAML frontmatter:

---
name: Prompt Name
description: Brief description of what this prompt does
tags: [tag1, tag2, tag3]
---

Your actual prompt content goes here...

Configuration

Configuration is stored in:

• Linux/Mac: ~/.config/gitizi-cli/config.json
• Windows: %APPDATA%\gitizi-cli\config.json

Development

# Clone the repository
git clone https://github.com/gitizi/gitizi-cli.git
cd gitizi-cli

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Link locally for testing
npm link

License

MIT

Support

• Website: https://gitizi.com
• Issues: https://github.com/gitizi/gitizi-cli/issues
• Email: [email protected]

Made with love by the Gitizi team