, naar de homepage
sys://cli

CLI Development

Een goede CLI doet één ding voorspelbaar, legt zichzelf uit met --help, faalt met een bruikbare foutmelding en is te gebruiken in scripts en pipelines. Dat maakt de terminal de snelste interface voor terugkerend technisch werk.

Bespreek je situatie
wat we bouwen

Wat we bouwen

  • Automatisering en batchverwerking

    Bestanden, records of API-calls in bulk verwerken, hervatbaar na een onderbreking.

  • Deploy- en infrastructuurtools

    Herhaalbare stappen voor builds, releases en omgevingen in één commando.

  • API-clients

    Een interne of externe API bedienen vanuit de terminal, met authenticatie en paginering geregeld.

  • AI-workflows in de terminal

    Modellen aanroepen op bestanden en datasets, met gestructureerde output die het volgende commando kan gebruiken.

  • Developer-productiviteit

    Kleine tools die de frictie uit een dagelijkse workflow halen.

engineering

Hoe het gebouwd wordt

De keuzes die bepalen of iets na maanden nog steeds werkt.

Gebruikte technologie

  • Node.js
  • TypeScript
  • Python
  • Go
  • JSON output
  • CI/CD
  • cron
Voorspelbare output
Leesbare output voor mensen, --json voor scripts, en exit codes die kloppen.
Configuratie
Flags, een configbestand en omgevingsvariabelen, in een vaste voorrangsvolgorde.
Foutmeldingen
Wat ging er mis, waarom, en wat je kunt doen. Geen stacktrace als eerste regel.
Installatie
Eén installatiecommando, en documentatie die naast de code leeft.
voorbeeld

Zo ziet een CTRL-CLI eruit

Bij elke testrun wordt deze website gebouwd en gecontroleerd door ctrl-check, een kleine CLI zonder dependencies die we voor dit project schreven. Hiernaast de echte --help-output, opgehaald tijdens de build.

Duidelijke commando’s, --json voor CI, en exit codes die scripts kunnen gebruiken.

$ ctrl-check --help
ctrl-check 1.0.0
Statische QA voor een gebouwde website-map.

Gebruik:
  ctrl-check [opties] <map>

Controleert per HTML-pagina:
  title (≤ 65 tekens), meta description (120–160), precies één <h1>,
  canonical, lang-attribuut, alt-tekst op afbeeldingen, geldige JSON-LD,
  interne links die bestaan, en verboden placeholdertekst.

Opties:
  --json        resultaat als JSON (voor scripts en CI)
  --help        deze hulptekst
  --version     versienummer

Exit codes:
  0  geen fouten   1  fouten gevonden   2  verkeerd gebruik
past dit bij jou?

Voor wie

  • Een technisch team herhaalt dezelfde reeks stappen met de hand.
  • Je wilt een proces scriptbaar maken voor CI/CD of cron.
  • Je biedt een API aan en wilt ontwikkelaars een snelle ingang geven.
in de praktijk
  • CLIWerkend, in eigen gebruik

    CtrlGmail

    Local-first CLI die meerdere Gmail-accounts synchroniseert naar SQLite, mail categoriseert, taken extraheert met een uitwisselbaar taalmodel en opruimt, standaard als dry-run.

    • Python
    • Gmail API
    • OAuth 2.0
    • SQLite
    • rich
    Lees de case study: CtrlGmail
insights

Verder lezen

faq

Veelgestelde vragen

Waarom een CLI en geen webinterface?

Voor terugkerend technisch werk is een CLI sneller, scriptbaar en makkelijk te combineren met andere tools. Voor incidenteel gebruik door niet-technische mensen is een webinterface beter.

Werkt het op Windows, macOS en Linux?

Dat is het uitgangspunt. Platformverschillen (paden, shells, line endings) worden getest.

Hoe wordt een CLI verspreid?

Afhankelijk van het team: via npm, pip, een binary per platform of een interne repository.

sys://contact

Wat wil je automatiseren of bouwen?

Beschrijf het proces, de tool of het product in een paar zinnen. Je krijgt een concreet antwoord: wat haalbaar is, hoe je het zou bouwen en waar de risico’s zitten.

Start een gesprekBekijk projecten