Ga naar hoofdinhoud

CLI Referentie

DROID+ wordt geleverd als een enkele binary met een set subcommando's voor het beheren van AI-agent runtimes.

droid

DROID+ — Headless AI Agent Runtime Engine. Zoals nginx websites serveert, serveert DROID+ AI-agents. Eén binary, één configuratie, productie-klare agents in enkele minuten.

Gebruik:

droid [command]

Beschikbare Commando's:

CommandoBeschrijving
initInitialiseer een nieuw DROID+ project
upStart de DROID+ runtime
downStop een draaiende DROID+ instantie
agentsLijst van draaiende agents
agents reloadHot-reload agent configuraties
healthControleer de gezondheid van de DROID+ server
versionToon versie-informatie

Globale Flags:

FlagBeschrijving
-h, --helpHelp voor droid

droid init

Maak een nieuwe map aan met een minimale DROID+ configuratie, een voorbeeld agent en een .env sjabloon.

Gebruik:

droid init [project-name]

Argumenten:

  • project-name — Naam van de aan te maken map (standaard: my-agent)

Voorbeeld:

droid init skincare-bot
cd skincare-bot

Aangemaakte bestanden:

  • droid.yaml — Hoofdconfiguratie
  • configs/agents/example.yaml — Voorbeeld agent configuratie
  • .env.example — Omgevingsvariabelen sjabloon

droid up

Start de DROID+ AI-agent runtime met OpenAI-compatibele API en Management API.

Gebruik:

droid up [flags]

Flags:

FlagTypeStandaardBeschrijving
--config, -cstringauto-detectPad naar configuratiebestand
--daemon, -dboolfalseDraai op de achtergrond (gebruik systemd/docker voor productie)

Voorbeelden:

# Start met automatisch gedetecteerde configuratie
droid up

# Start met specifiek configuratiebestand
droid up --config /etc/droid/droid.yaml

# Start op de achtergrond
droid up -d

droid down

Stuur SIGTERM naar het draaiende DROID+ proces met behulp van het PID-bestand.

Gebruik:

droid down

Voorbeeld:

droid down

droid agents

Vraag de Management API om alle geladen agents en hun status op te lijsten.

Gebruik:

droid agents [flags]

Flags:

FlagTypeStandaardBeschrijving
--portint8081Management API poort

Voorbeeld:

# Lijst agents op standaard poort
droid agents

# Lijst agents op aangepaste management poort
droid agents --port 9091

droid agents reload

Hot-reload agent configuraties zonder de runtime te herstarten. Leest de agents-map en past eventuele wijzigingen toe.

Gebruik:

droid agents reload

Voorbeeld:

# Voeg een nieuwe agent YAML toe, daarna reload
cp new-agent.yaml configs/agents/
droid agents reload

droid health

Controleer de gezondheid van de OpenAI-compatibele API en Management API endpoints.

Gebruik:

droid health [flags]

Flags:

FlagTypeStandaardBeschrijving
--openai-portint8080OpenAI API poort
--management-portint8081Management API poort

Voorbeeld:

# Controleer gezondheid op standaard poorten
droid health

# Controleer gezondheid op aangepaste poorten
droid health --openai-port 9080 --management-port 9081

droid version

Toon DROID+ versie-informatie.

Gebruik:

droid version [flags]

Flags:

FlagBeschrijving
--jsonUitvoer als JSON

Voorbeeld:

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

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