Handleiding voor de medewerker › Deel F · Bijlagen

24 De opdrachtregel

1. 24.1 Waar het programma staat
2. 24.2 De opdrachten
3. 24.3 Afsluiten
4. 24.4 Koppelen zonder venster
5. 24.5 Metingen overnemen uit een ander programma
6. 24.6 Claude-tijd nalopen (Windows)
7. 24.7 Toegang op de Mac nalopen

Deze bijlage is voor gevorderden, en voor wie Okloq op veel laptops tegelijk uitrolt. Normaal heb je de opdrachtregel niet nodig: alles wat hier staat kan ook in de vensters, behalve het overnemen van metingen uit een ander programma.

Je start Okloq dan vanuit de Opdrachtprompt of PowerShell (Windows) of de Terminal (Mac), met een opdracht erachter. Okloq opent daarbij geen venster. Het doet de opdracht en stopt.

24.1 Waar het programma staat

Okloq bewaart zijn gegevens ergens anders, zodat bijwerken en verwijderen ze niet raken:

Het log heeft per dag een bestand, bijvoorbeeld agent-20261028.log. Je opent de map ook met "Logmap openen" in het menu van Okloq.

24.2 De opdrachten

Andere opdrachten kent Okloq niet. Start je Okloq zonder opdracht terwijl het al draait, dan opent het dagoverzicht.

24.3 Afsluiten

--afsluiten sluit Okloq af, net als "Afsluiten" in het menu. Draait Okloq niet, dan gebeurt er niets.

"%LOCALAPPDATA%\OkloqAgent\current\Okloq.exe" --afsluiten

Gebruik dit voor --importeer, en op de Mac ook voor --koppel. Die werken alleen goed als Okloq niet draait. Op Windows sluit --koppel Okloq zelf af.

24.4 Koppelen zonder venster

--koppel doet hetzelfde als "Koppelen aan bedrijf…" (hoofdstuk 3 “Koppelen”), maar zonder venster. Dat is handig als een beheerder of specialist Okloq op veel laptops tegelijk klaarzet. Je geeft een koppelcode mee, en eventueel het adres van de dienst:

• --koppel <koppelcode> koppelt met het standaardadres https://app.okloq.com/;
• --koppel <adres> <koppelcode> koppelt met een ander adres, bijvoorbeeld als je bedrijf een eigen dienst heeft.

Elke laptop heeft een eigen koppelcode nodig: een code werkt maar één keer, 7 dagen lang, en bepaalt op wiens naam de uren komen.

Op Windows hoef je Okloq niet eerst af te sluiten. Draait Okloq al, dan sluit --koppel het eerst netjes af, koppelt, en start Okloq daarna weer. Draaide Okloq niet, dan blijft het na het koppelen uit; start het dan zelf.

Op de Mac sluit je Okloq eerst af met --afsluiten, koppelt met --koppel, en start Okloq daarna weer.

Zien of het gelukt is

Okloq zet de uitkomst in het opdrachtvenster. Is het gelukt, dan staat er "Gekoppeld aan … als …", met de naam van het bedrijf en van de medewerker. Lukt het niet, dan staat er dezelfde melding als in het venster "Koppelen aan bedrijf" (hoofdstuk 3 “Koppelen”). Ook in het log staat "Koppelen via de opdrachtregel niet gelukt", met de reden.

Op Windows schrijft Okloq de uitkomst ook in het bestand koppelen-uitslag.txt in de map met gegevens (%LOCALAPPDATA%\Okloq). Draaide Okloq al en reageert het niet op afsluiten, dan koppelt --koppel niet en staat er "Okloq draait nog en reageert niet op afsluiten. Sluit Okloq af via het systeemvak en probeer het opnieuw."

Voor een script geeft Okloq ook een getal terug, de exitcode:

In de Opdrachtprompt zie je de exitcode na start /wait met echo %ERRORLEVEL%, in PowerShell na Start-Process -Wait -PassThru in ExitCode.

Op de Mac gaat het zo:

• /Applications/Okloq.app/Contents/MacOS/Okloq --afsluiten
• /Applications/Okloq.app/Contents/MacOS/Okloq --koppel QH7RT-K2M9P

24.5 Metingen overnemen uit een ander programma

Stap je over van een ander programma dat je tijd meet, dan kun je die metingen meenemen met --importeer. Okloq zet ze bij je eigen metingen, alsof het ze zelf had gemeten. Ze verschijnen daarna gewoon in het dagoverzicht, waar je ze nog moet goedkeuren.

Het bestand is tekst met puntkomma's en een kopregel. Elke regel is één stuk tijd:

• start;eind;programma;dossier;titel
• 2026-10-12T09:00:00;2026-10-12T10:30:00;illustrator;2026-0012;Logo Bakkerij De Wit
• 2026-10-12 10:30;2026-10-12 11:00;mail;;Offerte nieuwe klant
• start en eind: de lokale tijd, als 2026-10-12T09:00:00 of 2026-10-12 09:00. Eén regel mag niet langer zijn dan 24 uur.
• programma: verplicht, bijvoorbeeld winword of illustrator.
• dossier: mag leeg. Vul je een dossiernummer in, dan telt dat als jouw eigen keuze, zoals in het gele blok van het dagoverzicht.
• titel: de venstertitel; mag leeg.

Sluit Okloq eerst af. Start dan:

/Applications/Okloq.app/Contents/MacOS/Okloq --importeer ~/Documents/oude-metingen.csv

Okloq schrijft de uitkomst in een bestand naast het jouwe, met .resultaat.txt erachter, hier oude-metingen.csv.resultaat.txt. Daarin staat bijvoorbeeld:

• 120 metingen gelezen (86,5 uur), 1 regels niet te lezen.
• 118 overgenomen, 2 overgeslagen omdat er op dat moment al een meting stond.
• Regel 37: tijd niet te lezen.

Okloq schrijft nooit over een meting heen die er al is. Een regel die overlapt met een bestaande meting, slaat het over. Start Okloq daarna weer.

24.6 Claude-tijd nalopen (Windows)

--claude schrijft in een tekstbestand op hoeveel tijd Claude Code de afgelopen twee weken per dag en per dossier bezig was. Okloq gebruikt daarvoor de instellingen van je laptop. Het bewaart niets en verandert niets; Okloq mag gewoon blijven draaien. Zo kun je nagaan of Okloq je Claude-sessies aan de goede dossiers koppelt, voordat je "Tijd meetellen waarin Claude voor een dossier aan het werk is (Claude Code)" aanzet (hoofdstuk 11 “Tabblad Dossiers”).

24.7 Toegang op de Mac nalopen

--bronnen schrijft in een tekstbestand wat macOS op dat moment aan Okloq laat zien: of Okloq toegang heeft bij Toegankelijkheid, welk programma vooraan staat, of er een venstertitel en een document gevonden zijn, hoe lang er geen invoer was, of de microfoon in gebruik is en of de sleutelhanger bereikbaar is. Van de venstertitel en het document staat alleen het aantal tekens erin, niet de tekst zelf.

/Applications/Okloq.app/Contents/MacOS/Okloq --bronnen ~/Desktop/bronnen.txt

Dit helpt als Okloq op de Mac geen dossiers herkent. Staat er "Toegankelijkheid: niet toegestaan", lees dan hoofdstuk 2 “Installeren”.