Freelo CLI

Freelo CLI je oficiální nástroj pro ovládání Freela z příkazové řádky (terminálu). Je napsán v jazyce Go a distribuován jako jediný spustitelný soubor – nevyžaduje Node.js, Python ani Docker.

Hodí se vývojářům, DevOps inženýrům a AI agentům, kteří potřebují automatizovat práci ve Freelu nebo přistupovat k němu ze skriptů a pipeline. Pokud jste běžný uživatel a hledáte způsob, jak propojit AI asistenta s Freelem, pravděpodobně hledáte Freelo MCP – přečtěte si článek Freelo MCP – napojení AI asistentů na Freelo.

CLI, MCP nebo n8n?

Různé integrační nástroje slouží různým účelům. Tato tabulka vám pomůže vybrat správný:

Freelo MCP je nejjednodušší cesta pro uživatele, kteří chtějí propojit AI asistenta s Freelem, aniž by potřebovali pracovat v terminálu. Více v článku Freelo MCP – napojení AI asistentů na Freelo.

Pro koho je Freelo CLI

Vývojáři a DevOps – kteří potřebují automatizovat práci ve Freelu: hromadné vytváření úkolů, integrace s CI/CD pipeline, GitHub Actions nebo vlastní skripty. CLI je single binary bez závislostí – stačí ho zkopírovat do pipeline.

AI agenti v terminálu – Claude Code a podobné nástroje používají CLI jako primární přístup k Freelo API. CLI obsahuje vestavěnou dovednost (embedded skill), která agentovi vysvětluje použití příkazů. Vy můžete zadat požadavek přirozeným jazykem; dostupné akce závisejí na verzi CLI a oprávněních vašeho Freelo účtu.

Pokročilí uživatelé – kteří preferují terminál před webovým rozhraním a chtějí provádět hromadné operace rychleji, než by to bylo možné přes web.

Co Freelo CLI umí

Freelo CLI zpřístupňuje hlavní oblasti API. Aktuální seznam skupin a operací zjistíte přes freelo --help a freelo <skupina> --help:

• Správa projektů, To-Do listů a úkolů
• Komentáře, přílohy a zmínky
• Podúkoly a vazby mezi úkoly
• Měření času, pracovní výkazy a faktury
• Vlastní pole, štítky a šablony
• Notifikace a záznamy aktivit

Výstupní formáty

CLI nabízí šest výstupních režimů přizpůsobených různým použitím:

Následující ukázky s rourou, jq a xargs jsou pro shell macOS/Linux. Pro první z nich je potřeba samostatně nainstalovaný jq.

Příklad – předání dat do dalšího zpracování:

freelo tasks list --project <ID_PROJEKTU> --page 0 --agent | jq '.[] | {id, name}'

tasks list při výpisu přes filtr projektu načte jednu stránku. Další získáte přes --page 1, --page 2 atd. Ani --count automaticky nesečte všechny stránky. Kombinace --project a --tasklist používá jiný endpoint; nepřidávejte k ní --search ani --state.

Příklad – hromadné dokončení vybraných úkolů: použijte vlastní testovací projekt. Nejprve si pouze vypište jeho aktivní úkoly; zástupné ID nahraďte skutečným číslem:

freelo tasks list --project <ID_TESTOVACIHO_PROJEKTU> --state 1 --page 0

Zkontrolujte názvy i ID. Do souboru vybrane-ukoly.txt ručně uložte pouze ID úkolů, které chcete dokončit, jedno číslo na řádek. Soubor před pokračováním otevřete a ověřte. Teprve potom spusťte následující příkaz, který už mění stav vybraných úkolů:

xargs -n 1 freelo tasks finish < vybrane-ukoly.txt

V PowerShellu můžete zkontrolované úkoly dokončit jednotlivě příkazem freelo tasks finish <ID_UKOLU>. Výpis úkolů nikdy nespojujte přímo s dokončováním bez kontroly výběru.

Instalace

Systémové požadavky

• Linux, macOS nebo Windows
• Freelo účet s API klíčem (přes avatar → Nastavení → API klíč)
• Pro instalaci přes go install navíc Go; pro sestavení ze zdrojového kódu také Git a make

Způsob 1: Instalační skript (macOS / Linux)

Nejrychlejší cesta – jeden příkaz stáhne a nainstaluje poslední vydání:

curl -fsSL https://raw.githubusercontent.com/freeloio/freelo-cli/main/install.sh | bash

Instalaci ověřte:

freelo --version

Úspěšné spuštění vypíše verzi ve tvaru freelo-cli vX.Y.Z; místo X.Y.Z uvidíte číslo své instalace.

Způsob 2: go install (macOS / Linux / Windows)

S nainstalovaným Go:

go install github.com/freeloio/freelo-cli/cmd/freelo@latest

Umístění binárního souboru určuje nastavení Go: pokud je GOBIN prázdné, používá se bin pod GOPATH (běžně ~/go/bin, na Windows %USERPROFILE%\go\bin). Tento adresář přidejte do uživatelské proměnné PATH, pokud tam ještě není, a otevřete nový terminál.

Způsob 3: Předkompilovaný binární soubor

Na stránce vydání (Releases) na GitHubu stáhněte archiv pro váš systém (darwin / linux / windows; pro Windows soubor freelo_windows_amd64.exe), rozbalte ho a přesuňte binární soubor freelo do adresáře v systémové PATH. Každé vydání obsahuje soubor checksums.txt pro ověření integrity.

Způsob 4: Sestavení ze zdrojového kódu

Postup pro macOS/Linux s nainstalovaným Git, Go a make. Příkaz make install sestaví CLI, uloží ho do ~/bin a zároveň se pokusí nainstalovat dovednost pro Claude Code. Adresář ~/bin musí být v PATH.

git clone https://github.com/freeloio/freelo-cli.git
cd freelo-cli
make install

Úspěšnou instalaci ověřte příkazem freelo --version.

Přihlášení

Interaktivní přihlášení (doporučeno)

freelo auth login

Přihlašovací údaje se uloží bezpečně do systémového trezoru hesel (Keychain na macOS, Windows Credential Manager na Windows, Secret Service na Linuxu). Ověřit stav přihlášení lze příkazem:

freelo auth status

Proměnné prostředí (pro CI/CD a Docker)

V automatizovaných prostředích bez interaktivního vstupu nastavte přihlašovací údaje jako proměnné prostředí. Ukázka pro shell macOS/Linux (zástupné hodnoty nahraďte svými):

export FREELO_EMAIL=user@example.com
export FREELO_API_KEY=váš-api-klíč

V PowerShellu nastavíte proměnné pro aktuální relaci takto:

$env:FREELO_EMAIL = "user@example.com"
$env:FREELO_API_KEY = "vas-api-klic"

API klíč najdete ve Freelu přes avatar → Nastavení → API klíč. Podrobný návod k API klíčům je v článku Freelo API a API klíč.

⚠️ Bezpečnost: API klíč dává plný přístup k vašemu Freelo účtu. Nikdy ho neukládejte přímo do kódu ani do verzovacích systémů. Při podezření na únik ihned vygenerujte nový klíč v nastavení profilu.

Základní příkazy

freelo users me                             # Zobrazí váš profil
freelo projects list                        # Seznam všech projektů
freelo projects show <ID>                   # Detail projektu
freelo tasks list --project <ID>            # Úkoly v projektu
freelo tasks list --search "výraz"          # Fulltextové vyhledávání
freelo tasks create --project <ID> --tasklist <ID> --name "Název úkolu"
freelo tasks edit <ID> --priority h --due-date 2026-12-31
freelo comments create --task <ID> --content "Text komentáře"
freelo tasks finish <ID>                    # Označí úkol jako dokončený
freelo --help                               # Nápověda ke všem příkazům

Přímý přístup k API

Pokud potřebujete endpoint, který aktuální verze CLI nepokrývá standardním příkazem, použijte přímé volání přes freelo api:

freelo api get /archived-projects --agent
freelo api post /search --data '{"search_query":"výraz"}' --agent

AI integrace

Freelo CLI obsahuje vestavěnou dovednost (embedded skill) s instrukcemi pro AI agenty. Pomáhá jim vybrat příkazy pro práci s Freelem; rozsah závisí na instalované verzi CLI a přístupech vašeho účtu.

Instalace dovednosti:

freelo skill install claude     # Claude Code
freelo skill install codex      # OpenAI Codex
freelo skill install opencode   # OpenCode
freelo skill install all        # Všechny podporované agenty

Po instalaci otevřete nový rozhovor s AI agentem a komunikujte přirozeným jazykem:

„Zobraz mi aktivní úkoly s termínem tento týden a vytvoř 90minutový pracovní výkaz k nejstaršímu z nich.“

AI agent podle zadání a instrukcí dovednosti vybírá a spouští příkazy freelo. Jejich výsledky vám vysvětlí v konverzaci. Samotné CLI přirozený jazyk nezpracovává.

Řešení problémů

Kam dál

• Oficiální repozitář Freelo CLI a aktuální README
• Freelo MCP – napojení AI asistentů na Freelo
• Freelo API a API klíč
• Referenční dokumentace Freelo API