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), díky níž AI agent komunikuje s Freelem přirozeným jazykem bez explicitní znalosti příkazů.

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 pokrývá přibližně 70 API endpointů organizovaných do 24 skupin příkazů:

• 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:

Příklad – předání dat do AI zpracování:

freelo tasks list --agent | jq '.[] | {id, name}'

Příklad – hromadné dokončení úkolů:

freelo tasks list --ids-only | xargs -I {} freelo tasks finish {}

Instalace

Systémové požadavky

• Linux, macOS nebo Windows
• Freelo účet s API klíčem (sekce Nastavení profilu → API)
• Pro instalaci přes go install navíc Go; pro sestavení ze zdroje Git

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

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

S nainstalovaným Go:

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

Binární soubor přistane v adresáři go env GOBIN (výchozí ~/go/bin, na Windows %USERPROFILE%\go\bin) – ujistěte se, že je v systémové PATH. Na Windows v PowerShellu lze cestu přidat příkazem setx PATH "$env:PATH;$env:USERPROFILE\go\bin".

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

git clone git@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í:

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

API klíč najdete ve Freelu v sekci Nastavení profilu → API. 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) pro AI agenty, která AI agentovi poskytne znalost celého Freelo API bez nutnosti explicitně znát příkazy.

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."

CLI pak na pozadí samo volá správné příkazy a vrací výsledky do konverzace.

Řešení problémů

Kam dál

• Freelo MCP – napojení AI asistentů na Freelo
• Freelo API a API klíč
• Referenční dokumentace Freelo API