Installation (outdated)
This page is outdated. See the CLI docs 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:
- Open this link: t.me/aigon_notetaker_bot
- Click Start to begin
- 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:
- Open this link: t.me/aigon_auth_bot
- Click Start
- Send the command:
/get - 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):
# 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 (direct download)
- 📁 View on GitHub (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:
# 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):
# 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:
~/Downloads/aigon config show
Step 5: Read Your Notes
Now you can read your notes from the command line:
# 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 helpto see how to use it."
The AI can then read your notes and help you work with them. Some useful commands for AI assistants:
# 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
# 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 --helpfor command reference - Visit the Notetaker bot: t.me/aigon_notetaker_bot
- Contact us at support@aigon.ai