# Installation (outdated)

> **This page is outdated.** See the [CLI docs](/docs/cli/) for current installation instructions.

This guide will help you set up Aigon CLI to access your notes from the command line or through AI assistants like Claude Code.

## Getting Started

### Prerequisites

- A Mac or Linux computer
- Python 3.10 or later (most Macs already have this)
- Telegram app (for account setup)

## Step 1: Create Your Account

Open Telegram and message the Aigon Notetaker bot to create your account:

1. Open this link: [t.me/aigon_notetaker_bot](https://t.me/aigon_notetaker_bot)
2. Click **Start** to begin
3. Send a few test notes (voice messages, text, or photos)

The bot will save your notes. You can always come back to add more.

## Step 2: Get Your API Key

Now get an API key so you can access your notes from the command line:

1. Open this link: [t.me/aigon_auth_bot](https://t.me/aigon_auth_bot)
2. Click **Start**
3. Send the command: `/get`
4. Copy the token it gives you (you'll need it in Step 4)

## Step 3: Download the Aigon CLI

Download the `aigon` command-line tool. First, open the Terminal app:

- On Mac: Press `Cmd + Space`, type "Terminal", and press Enter

Then run these commands (copy and paste each line):

```bash
# Go to your Downloads folder
cd ~/Downloads

# Download aigon
curl -O https://github.com/aigonai/aigonone-firmware/raw/main/aigon_cli/aigon

# Make it executable
chmod +x aigon
```

Alternatively, download from your browser:

- ⬇️ [Download aigon](https://github.com/aigonai/aigonone-firmware/raw/main/aigon_cli/aigon) (direct download)
- 📁 [View on GitHub](https://github.com/aigonai/aigonone-firmware/tree/main/aigon_cli) (see README and files)

After downloading, run `chmod +x ~/Downloads/aigon` in Terminal to make it executable.

You now have `aigon` in your Downloads folder. You can keep it there, or move it somewhere else:

```bash
# Optional: move to a bin folder (creates it if needed)
mkdir -p ~/bin
mv aigon ~/bin/
```

## Step 4: Configure Your API Key

Still in Terminal, configure your API key (paste the token from Step 2):

```bash
# If aigon is in Downloads:
~/Downloads/aigon config set api.token YOUR_TOKEN_HERE

# Or if you moved it to ~/bin:
~/bin/aigon config set api.token YOUR_TOKEN_HERE
```

Verify it's configured:

```bash
~/Downloads/aigon config show
```

## Step 5: Read Your Notes

Now you can read your notes from the command line:

```bash
# Read your 5 most recent notes
~/Downloads/aigon notetaker read --limit 5

# Read all notes (including older ones)
~/Downloads/aigon notetaker read --all --forever --limit 20

# Search your notes
~/Downloads/aigon notetaker search "meeting"
```

## Using with Claude Code or AI Assistants

You can use Aigon with AI coding assistants like Claude Code. Tell your AI assistant:

> "The aigon command is at ~/Downloads/aigon (or wherever you put it). Run `aigon llm help` to see how to use it."

The AI can then read your notes and help you work with them. Some useful commands for AI assistants:

```bash
# Show LLM-specific help
~/Downloads/aigon llm help

# Get notes in a format optimized for LLMs
~/Downloads/aigon notetaker read --format llm --limit 10
```

## Quick Reference

```bash
# Configuration
aigon config show              # Show current config
aigon config set api.token X   # Set API token
aigon config help              # Config help

# Notes
aigon notetaker read --limit 5         # Read recent notes
aigon notetaker read --all --limit 50  # Read all notes
aigon notetaker search "keyword"       # Search notes

# Help
aigon --help                   # General help
aigon notetaker --help         # Notetaker help
aigon llm help                 # Help for AI assistants
```

## Need Help?

- Check `aigon --help` for command reference
- Visit the Notetaker bot: [t.me/aigon_notetaker_bot](https://t.me/aigon_notetaker_bot)
- Contact us at support@aigon.ai
