Dokumentacja CLI

DROID+ jest dostarczany jako pojedynczy plik binarny z zestawem poleceń do zarządzania silnikami uruchomieniowymi agentów AI.

droid

DROID+ — Silnik uruchomieniowy agentów AI typu headless. Tak як nginx serwuje strony internetowe, DROID+ serwuje agentów AI. Jeden plik binarny, jedna konfiguracja, agenci gotowi do produkcji w kilka minut.

Użycie:

droid [command]

Dostępne polecenia:

Polecenie	Opis
init	Inicjalizacja nowego projektu DROID+
up	Uruchomienie silnika DROID+
down	Zatrzymanie uruchomionej instancji DROID+
agents	Lista uruchomionych agentów
agents reload	Gorące przeładowanie konfiguracji agentów
health	Sprawdzenie stanu serwera DROID+
version	Wyświetlenie informacji o wersji

Flagi globalne:

Flaga	Opis
-h, --help	Pomoc dla droid

---

droid init

Utworzenie nowego katalogu z minimalną konfiguracją DROID+, przykładowym agentem i szablonem .env.

Użycie:

droid init [project-name]

Argumenty:

• project-name — Nazwa katalogu do utworzenia (domyślnie: my-agent)

Przykład:

droid init skincare-bot
cd skincare-bot

Utworzone pliki:

• droid.yaml — Główna konfiguracja
• configs/agents/example.yaml — Konfiguracja przykładowego agenta
• .env.example — Szablon zmiennych środowiskowych

---

droid up

Uruchomienie silnika agentów AI DROID+ z API zgodnym z OpenAI oraz Management API.

Użycie:

droid up [flags]

Flagi:

Flaga	Typ	Domyślnie	Opis
--config, -c	string	autowykrywanie	Ścieżka do pliku konfiguracyjnego
--daemon, -d	bool	false	Uruchomienie w tle (użyj systemd/docker w produkcji)

Przykłady:

# Uruchomienie z autowykrywaniem konfiguracji
droid up

# Uruchomienie ze specyficznym plikiem konfiguracji
droid up --config /etc/droid/droid.yaml

# Uruchomienie w tle
droid up -d

---

droid down

Wysłanie sygnału SIGTERM do uruchomionego procesu DROID+ przy użyciu pliku PID.

Użycie:

droid down

Przykład:

droid down

---

droid agents

Zapytanie do Management API o listę wszystkich załadowanych agentów i ich status.

Użycie:

droid agents [flags]

Flagi:

Flaga	Typ	Domyślnie	Opis
--port	int	8081	Port Management API

Przykład:

# Lista agentów na domyślnym porcie
droid agents

# Lista agentów na niestandardowym porcie zarządzania
droid agents --port 9091

droid agents reload

Gorące przeładowanie konfiguracji agentów bez restartowania silnika. Odczytuje katalog agentów i stosuje wszelkie zmiany.

Użycie:

droid agents reload

Przykład:

# Dodaj nowy plik YAML agenta, a następnie przeładuj
cp new-agent.yaml configs/agents/
droid agents reload

---

droid health

Sprawdzenie punktów końcowych stanu (health endpoints) API zgodnego z OpenAI oraz Management API.

Użycie:

droid health [flags]

Flagi:

Flaga	Typ	Domyślnie	Opis
--openai-port	int	8080	Port OpenAI API
--management-port	int	8081	Port Management API

Przykład:

# Sprawdzenie stanu na domyślnych portach
droid health

# Sprawdzenie stanu na niestandardowych portach
droid health --openai-port 9080 --management-port 9081

---

droid version

Wyświetlenie informacji o wersji DROID+.

Użycie:

droid version [flags]

Flagi:

Flaga	Opis
--json	Wyjście w formacie JSON

Przykład:

droid version
# DROID+ v0.5.0 (community) built ...

droid version --json
# {"version":"0.5.0","edition":"community","commit":"...","build_time":"..."}