On this page
You have several projects going at once. You set one aside to pick up another, and three weeks later you no longer know which one has stalled, what it was waiting on, or which one should come first.
This tool looks at your folders where they live, on your own computer, and draws an overview on a board you open in your browser. One card per folder: how long nothing has moved, what is under way, what is waiting on someone, what earns money, what is not backed up.
You type nothing. Whatever can be measured is measured on its own. You only write what a machine cannot guess: what this folder is for, what you are waiting on, the next step.
This is not project-management software. It plans nothing, does not count your hours, does not assign you tasks and warns nobody on your behalf. It shows.
There is one single file to download, and nothing to install. Pick yours:
| Your computer | The file |
|---|---|
| Recent Mac (Apple silicon — M1, M2, M3…) | portefeuille-mac-silicon |
| Older Mac (Intel processor) | portefeuille-mac-intel |
| Linux | portefeuille-linux |
| Windows | portefeuille-windows.exe |
If you are not sure which Mac you have: Apple menu, "About This Mac". If the line mentions "Apple chip", take the silicon build; if it mentions "Intel processor", take the other one.
Put that file wherever you like, then run it once with the -reglages option:
./portefeuille-mac-silicon -reglages
A page opens in your browser and walks you through the whole thing: your account, your board, your folders, the update, and even the automatic update every morning. Everything that follows in this guide can be done there by clicking. The rest of this document describes the same steps by hand, for those who prefer it, and serves as a reference when something gets stuck.
The assistant never leaves your computer: that page is visible to you alone.
On a Mac, the first time you run it, the system may say the file comes from an unidentified developer. Right-click the file, choose "Open", and confirm. You only have to do it once. This is the normal macOS protection for any program downloaded outside the App Store.
If your folders are tracked by git, the tool will get far more out of them (pace of work, unsaved work, missing backup). If not, it falls back on file dates, which is already enough.
Sign in to the site, go to Whiteboard, click + Board and give it any name you like: "My projects", "Workshop", your first name, it does not matter. You will put that name in your settings at step 4, and you can change it whenever you want.
You can also have several boards — one for your clients and one for your own projects, for instance: each folder can name its own.
If you would rather the tool created it for you, the assistant has a button for that, and on the command line the -creer-tableau option does the same.
The key allows the tool to write on your boards, and nothing else: not your invoices, not your clients, not your account.
Go to My account, section API tokens, give it a name that will mean something to you later ("My laptop", say) and click Create token.
A long string starting with omk_ appears. Copy it straight away: it will never be shown again. If you lose it, no harm done — create another one and revoke the old one in a click.
This key is a password. Do not send it to anyone, do not paste it into a message. If it ever gets away from you, revoke it from the same page: it stops working immediately.
Copy the downloaded file wherever you like, in your Documents for example. It does not install itself, it just sits there. Nothing else on your computer is modified.
Create a text file at exactly this location:
~/.config/portefeuille/config.json
The ~ means your home folder. If the .config/portefeuille folder does not exist, create it. In a terminal, one line is enough:
mkdir -p ~/.config/portefeuille
Put this inside, replacing the values with your own (a template is provided in config-exemple.json):
{
"api": "https://is4you.ch",
"jeton": "omk_your_key_here",
"tableau": "Portfolio",
"racine": "/Users/your-name/dev"
}
Then protect that file, since it holds your key:
chmod 600 ~/.config/portefeuille/config.json
A folder is only tracked if it contains a file named projet.yml at its root. That is deliberate: you choose what you track, the tool does not invite itself.
Create that file in one of your work folders. One line is the minimum:
nom: Martin's bakery website
And here is the full version, to copy and prune. Everything is optional except nom.
nom: Martin's bakery website
type: client # client, produit, interne or associe
pour: Martin's bakery # the client, the partner, or nothing if it is for you
etat: actif # actif, stable, en_attente, pause, livre or abandonne
en_attente_de: the photos the client promised
depuis: 2026-08-05 # since when you have been waiting
en_service: oui # people are ALREADY using it today
sauvegarde: my host, backup included in the contract
avancement: 60 # as a percentage, leave empty if you cannot say
reste: 12h # what is left to do, roughly
echeance: 2026-09-30 # the date you promised, empty if there is none
urgence: the client opens the shop in October
prochaine_etape: Add the photos and publish
en_cours:
- Opening hours page
- Contact form
en_test:
- Order basket, waiting on your opinion
livre_recemment:
- New home page
sources: # the places this folder actually lives in
- .
- ../bakery-api
The field names stay in French: they are the file format, the same on every machine, and a folder written by a colleague must read the same as yours. Four of them deserve an explanation — they are the ones that make the difference.
etat: en_attente says that nothing is moving because you are waiting on someone, not because you gave up. Without it, the tool would show in red a folder that has nothing to answer for.
en_service: oui says people are already using this work. The tool then presents it differently — but it will NEVER hold it against you for not touching it any more: a piece of software does not decay because it stops moving. People maintain programs untouched for years, watching them and stepping in when there is a problem.
etat: stable says so explicitly: this folder is online, it sells or is maintained as it stands, and if it no longer moves it is because there is nothing to change. Its card then keeps its colour instead of cooling down month after month, and the tool stops asking you for news. Finished software does not have to apologise for standing still. The day you pick the work up again, set it back to actif.
The only thing the tool still allows itself is to point out a contradiction between your file and the facts: if a folder is declared actif and nothing has moved for three months, it asks "stable?". That is not a judgement on the software — the machine knows nothing about that — it is a doubt about the file, and the answer is one word away.
sauvegarde: switches off the "no copy outside this machine" alert. The tool can see that a folder has no remote repository; it cannot know that it is backed up somewhere else — by your host, an external drive, a sync service. Write down where, in plain words. Careful: this says nothing about work not yet saved on your machine, which is still flagged separately.
sources: is for when a folder lives in several places. The dot means "this folder". Add the other paths underneath. If you only have one, remove the whole block.
Money never goes in this file, because it can be shared with the client. See below.
In a terminal, from the folder where you put the tool:
./portefeuille
You get the list of your tracked folders, and below it the list of those that are alive but that you do not track yet. Nothing has been sent anywhere: this command only reads.
./portefeuille -publier
Open your board in the browser: the cards appear within seconds, without reloading.
Run the command as often as you like. It never creates duplicates, and it does not move the cards you have arranged: you organise your board however you want, the tool only rewrites the contents. Your own notes, sticky notes and drawings are never touched.
In the assistant, last step: pick a time and click Schedule the update. That is all. Your board will be current when you sit down in the morning, and you will never have to think about it again.
If your folders are tracked by git, you can also republish on every commit, which keeps the board accurate to the minute. A post-commit file in your global git hooks is enough:
mkdir -p ~/.config/git/hooks
printf '#!/bin/sh\n( portefeuille -publier >/dev/null 2>&1 & ) &\nexit 0\n' \
> ~/.config/git/hooks/post-commit
chmod +x ~/.config/git/hooks/post-commit
git config --global core.hooksPath ~/.config/git/hooks
It runs in the background: it never delays your commit and cannot make it fail.
The program uses whatever your system provides: launchd on macOS, cron on Linux, Task Scheduler on Windows. You can click several times without creating duplicates — the task is simply replaced.
To remove it later: on macOS, delete the file ~/Library/LaunchAgents/ch.portefeuille.maj.plist; on Linux, crontab -e and delete the line; on Windows, delete the "Portefeuille" task in Task Scheduler.
Under each card, a Resume here panel answers the only question you ask when reopening a folder left alone for three weeks: where was I.
It shows the branch you were working on if it is not the main one, the last files you had open, and the last things you did, with dates.
You have nothing to do to get it, and nothing to fill in: it is all read from git. What you see is the text of your own commit messages, stripped of the technical prefix. Which means the quality of your resumptions is exactly the quality of your messages — a good reason to write them for yourself in six months rather than for the machine.
That panel stays strictly private. It never goes onto a shared board, even if you asked for it: the names of your files are none of your client's business.
You are reading something on your phone and you want to keep it. The gesture is the same as sending it by message: you share, you pick the board, it is placed. What lands is not a bare address but a readable card — the page title, the address, and the passage you had selected as a caption. A YouTube link becomes a thumbnail you can watch in place.
Nothing to write. Open the site in Chrome, menu, Add to Home screen. The board then appears in your phone's "Share" menu, like any other app. You share, you tap the board you want, and that is it.
The list shows your boards, the most recently used first. There is no default board, deliberately: a silent choice would one day send a link to the wrong place without you understanding why.
Apple does not allow web apps into the share menu. So we go through Shortcuts, the app that ships with every iPhone. The result is the same: your board appears in the share menu, below the app icons.
Ten minutes, once.
Open the Shortcuts app and tap +. The editor opens straight away without asking for a name — that is normal; the name and the settings live elsewhere. At the top centre the shortcut is called "New Shortcut", with a chevron ⌄ right next to it.
Back in the editor, a block has appeared at the very top of the shortcut: "Receive Apps and 18 more from Share Sheet". That is where the input types are set — there, and nowhere else. Not in the Details page.
Tap the blue label "Apps and 18 more" and uncheck everything except URLs, Text and Safari web pages. Otherwise the shortcut will also offer itself when you share a photo or a file, where it has no business being.
Leave "If there's no input: Continue" as it is: that is what lets you run the shortcut by hand to try it out.
The chevron menu only holds Rename, Choose Icon, Duplicate, Move and "Add to Home Screen". It is the ⓘ button, and only that, which opens Details. Apple has moved this setting several times and their own help page shows it as a picture without naming it — it is an "i" inside a circle. Look anywhere else and you will not find it.
Then add three actions, in this order. Search for them by name in the "Search for actions" field.
https://is4you.ch/partage?url= with no trailing space. Then, with the cursor still in the field, tap the blue token labelled "Encoded URL Text" in the bar above the keyboard — the output of action 1. Not the "Select Variable" button to its left: the token itself, on the right. It lands right against the =, with no space. You tap it, you do not drag it.You should read: https://is4you.ch/partage?url= followed by the token.
That is all. Safari opens on the picker page, you tap the board you want, and the item is placed — exactly as on Android.
No key ever leaves your server. The shortcut sends nothing itself: it opens a page, and your Safari session identifies you. Nothing to copy, nothing to revoke if you lose your phone. The first time, Safari will ask you to sign in to the site — once, like any other service.
After that, in Safari or any app: Share button, then "Add to board" in the list of actions.
The key stays on your phone. It opens your boards only — never your invoices, never your account — and you revoke it in one click from My account. Do not put the same key on several devices: one key per device can be revoked without disturbing the others.
When a project is done, do not delete its file: change its state.
etat: livre
livre_le: 2026-09-15
It then leaves the grid of current folders and joins a Finished card, listing what you delivered and when. Two reasons for that choice. A finished project no longer needs your attention, so it has no business sitting among the others, and above all it must not appear there as neglected when it is simply complete. But erasing it would be worse: what you have delivered is precisely what proves you are moving forward, and it is what people forget fastest.
A project you abandon is declared etat: abandonne and joins the same card, in its own list. Better to own it than to let it sleep indefinitely.
You can publish a project's progress on a second board, shared with your client, without ever showing them the rest.
Create a board on the site ("Martin's bakery — progress"), share it by link from the Sharing button, then add this at the end of the projet.yml of the folder concerned:
partage:
tableau: Martin's bakery — progress
champs: nom, avancement, prochaine_etape, en_cours, en_test, livre_recemment
Then publish with:
./portefeuille -publier -partages
What your client will never see, whatever you write in this file: no amount, no rate, no revenue share, none of your internal notes, no technical alert. The list of what may go out is fixed in the program, not in your file: a typo cannot let anything through.
It lives in a separate file, which never leaves your computer and is never shared:
~/.config/portefeuille/valeurs.json
{
"martin-site": {
"modele": "facture",
"valeur": 3500
},
"mytool": {
"modele": "recettes_partagees",
"part": "50 %",
"recurrent_mensuel": 400
}
}
The key (martin-site) is the folder name, or the slug if you declared one in the projet.yml. valeur is what is left to invoice, recurrent_mensuel what the folder earns every month.
This tool reads your files on your computer. Nothing is sent anywhere except what you publish on purpose: the names of your folders, their state, and what you wrote in the cards. The content of your work, your files, your code never leave.
"Aucun dossier suivi pour l'instant" — no folder tracked yet No projet.yml was found. Check that the racine in your settings really points at the folder holding your work, and that the file is named exactly projet.yml, with no dot in front.
"Adresse et jeton manquants" — address and token missing The settings file is absent or incomplete. The message gives you its exact location. Check there is no trailing comma at the end of the last line: the format is strict there.
"Aucun tableau nommé …" — no board by that name The name in your settings matches none of your boards. The message lists the ones you have: copy the right one. To have the tool create it for you, add -creer-tableau to the command, or use the assistant.
"Jeton inconnu, révoqué ou expiré" — unknown, revoked or expired token The key was mistyped, revoked, or has passed its lifetime. Create a new one from My account.
"Ce jeton n'a pas la portée …" — this token does not have the scope Normal and intended: your key only works on boards. There is nothing to fix.
"Configuration illisible" — unreadable configuration The settings file is not valid JSON, nearly always because of an extra comma or a missing quote. Copy config-exemple.json again and fill it in afresh.
"permission denied" when starting, on macOS or Linux The file is not allowed to run. One command fixes it: chmod +x portefeuille-mac-silicon (with the name of your own file).
Everything works the same. Replace ~ with your home folder in the paths, and run the program from the command prompt or by double-clicking it. The automatic update goes through Task Scheduler, which the assistant sets up for you.
projet.yml): the small file you drop in a folder to have it tracked.