A portable offline companion for Clair Obscur: Expedition 33, built for the M5Stack Cardputer / Cardputer-ADV.
Fast builds. Boss tips. Team ideas. Inventory-aware recommendations.
All in your pocket. No internet required.
Clair Companion turns the M5Stack Cardputer into a tiny handheld guide for Clair Obscur: Expedition 33.
Instead of checking your phone every few minutes, you can quickly browse characters, weapons, Pictos, Luminas, builds, bosses and team suggestions directly from the Cardputer.
Designed to be:
- ⚡ Fast
- 📴 Fully offline
- 🎮 Game-focused
- 🧠 Easy to navigate
- 💾 microSD friendly
- 🔋 Perfect for portable hardware
Browse information for:
- Gustave
- Maelle
- Lune
- Sciel
- Verso
- Monoco
Access character-specific skills, weapons, Pictos, Luminas and recommended builds.
Choose:
- your character
- your objective
- your current game phase
Clair Companion recommends the most suitable build using an offline rules engine.
No Wi-Fi. No cloud. No API.
Browse the global Picto catalog, search entries and track what you own.
Luminas can also be marked as learned and used by the inventory system.
Browse weapons, inspect details and track which ones are already in your inventory.
Each build includes:
- Overview
- Skills
- Pictos & Luminas
- Rotation
- Practical tips
- Inventory check
Clair Companion can tell you immediately whether a build is ready:
LISTA
or how many items are still missing:
FALTAN 3
Boss entries include useful combat information such as:
- weaknesses
- resistances
- elemental absorption
- strategy
- recommended build
- recommended team
When opening a team from a boss, the recommendation also considers elemental matchups.
Track:
- owned weapons
- owned Pictos
- learned Luminas
Your inventory is stored on the microSD card and can influence build and team recommendations.
Choose:
- main character
- objective
- game phase
Clair Companion suggests two teammates and a recommended build for every member.
You can also open the recommended build directly and view a suggested team rotation.
| Key | Action |
|---|---|
W |
Move up |
A |
Move down |
ENTER |
Open / Next |
DEL |
Back |
F |
Search in global catalogs |
Simple controls, because nobody wants to fight a menu while fighting a boss.
Designed for:
- M5Stack Cardputer
- M5Stack Cardputer-ADV
- ESP32-S3
- microSD storage
Developed with:
- PlatformIO
- Visual Studio Code
- M5Cardputer library
- Arduino framework
Clair Companion uses JSON files on the microSD card when available and also includes embedded fallback data.
Main data files include:
/clair/characters.json
/clair/skills.json
/clair/weapons.json
/clair/pictos.json
/clair/builds.json
/clair/bosses.json
/clair/advisor_rules.json
/clair/team_profiles.json
/clair/profile.json
This makes the project easy to expand without rebuilding the whole application.
git clone https://github.com/ickabel/ClairCompanion.gitInstall the PlatformIO extension if you do not already have it.
Connect the device over USB.
Use PlatformIO:
Build
Upload
If your device does not enter upload mode automatically:
- Disconnect / power off the Cardputer
- Hold
G0 - Connect USB
- Release
G0 - Upload again
Clair Companion does not need an internet connection during normal use.
That means:
- no accounts
- no subscriptions
- no loading screens from web services
- no API keys
- no mobile connection required
Just turn it on and play.
v1.8.0 — Stable
This is the first stable release of Clair Companion.
It includes the complete core experience:
Characters · Advisor · Pictos · Weapons · Builds · Bosses · Inventory · Teams
Coming soon.
Cardputer screenshots and photos will be added here in a future update.
Clair Companion v1.8.x will focus mainly on:
- bug fixes
- more data
- content corrections
- visual polish
- small quality-of-life improvements
Larger experimental features will be saved for a future v2.x.
Because tiny computers are more fun when they do something weirdly specific.
And having a dedicated Clair Obscur companion running on a Cardputer is definitely more fun than opening another browser tab.
If you like the project:
- ⭐ Star the repository
- 🐛 Open an issue if you find a bug
- 💡 Share ideas for future versions
- 🔧 Fork it and experiment
Clair Companion is an unofficial fan-made project.
It is not affiliated with, endorsed by, or sponsored by Sandfall Interactive, Kepler Interactive, M5Stack or their respective partners.
Clair Obscur: Expedition 33 and related names are trademarks of their respective owners.
Power on. Pick your build. Paint the world.