MAIP - Machine Identity & Integrity for VS Code
The Machine-Actionable Integrity Protocol (MAIP) extension brings machine identity management, cryptographic action receipts, trust scoring, and agent delegation directly into your VS Code workflow.
Get Started in 10 Seconds (Free — No Website Needed)
- Install the extension
- Open Command Palette (
Ctrl+Shift+P) and run: MAIP: Register Developer
- Enter your email — that's it! API key is stored securely.
- Right-click any file → Protect with Truthlocks
No website visit, no credit card, no onboarding forms. You get 100 free protections/month instantly.
You can also register via CLI: npx @truthlocks/protect register --email you@example.com
Or via Python: pip install truthlock && python -c "from truthlock import TruthlockClient; import asyncio; asyncio.run(TruthlockClient.register('you@example.com'))"
Or via cURL: curl -X POST https://sandbox-api.truthlocks.com/v1/developers/register -H "Content-Type: application/json" -d '{"email":"you@example.com","source":"vscode"}'
Features
- Developer Signup — Register with just an email directly from VS Code. No website needed.
- Agent Registration — Register and manage machine identities (agents) from the command palette.
- Action Receipts — Create cryptographic receipts for file changes, git commits, and arbitrary actions.
- Receipt Verification — Verify the integrity and authenticity of any MAIP receipt.
- Trust Scores — View real-time trust scores for agents in your workspace.
- Delegation Chains — Inspect and manage agent delegation hierarchies.
- Auto-Receipt on Save/Commit — Optionally generate receipts automatically when you save files or commit to git.
- Inline Trust Badges — See trust score indicators directly in your editor.
- Usage Meter — Status bar shows "Truthlocks: X/100" so you always know your usage.
- 10 Signing Algorithms — Ed25519, ES256, ES384, ES512, RS256, RS384, RS512, PS256, PS384, PS512.
- Audit Export — Export a full audit report of all receipts and agent activity.
Activity Bar
The extension adds a MAIP panel to the Activity Bar with three tree views:
| View |
Description |
| Agents |
Registered machine identities |
| Receipts |
Cryptographic action receipts |
| Delegations |
Agent delegation chains |
Commands
Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and type MAIP to see all available commands:
| Command |
Description |
| MAIP: Register Developer |
Sign up with email — get API key instantly (FREE) |
| MAIP: Configure Credentials |
Guided setup wizard for API creds |
| MAIP: Test Connection |
Verify API connectivity |
| MAIP: Register Agent |
Register a new machine identity |
| MAIP: Create Receipt |
Create a receipt for an action |
| MAIP: Verify Receipt |
Verify a receipt's integrity |
| MAIP: Show Trust Score |
Display an agent's trust score |
| MAIP: List Receipts |
Show all receipts |
| MAIP: Export Audit Report |
Export audit data |
| MAIP: Refresh |
Refresh all MAIP views |
Configuration
| Setting |
Default |
Description |
maip.apiUrl |
https://sandbox-api.truthlocks.com/v1 |
MAIP API base URL |
maip.apiKey |
|
Your MAIP API key (auto-set by Register Developer) |
maip.tenantId |
|
Tenant ID (auto-set by Register Developer) |
maip.agentId |
|
Agent ID for this workspace |
maip.signingAlgorithm |
Ed25519 |
Signing algorithm (10 options) |
maip.autoReceiptOnSave |
false |
Auto-generate receipt on file save |
maip.autoReceiptOnCommit |
true |
Auto-generate receipt on git commit |
maip.showTrustBadges |
true |
Show inline trust score badges |
Free Tier (No Credit Card Required)
| Resource |
Limit |
| Protections/Attestations |
100/month |
| Verifications |
1,000/month |
| API Keys |
3 |
| Signing Algorithms |
All 10 |
When you hit limits, the status bar turns yellow and shows an upgrade link.
Upgrade at console.truthlocks.com/upgrade.
Installation
From VS Code Marketplace
Search for MAIP in the Extensions view (Ctrl+Shift+X), or install directly:
ext install truthlocks.maip-vscode
From VSIX (GitHub Releases)
- Download the latest
.vsix from GitHub Releases.
- In VS Code, open the Command Palette and run
Extensions: Install from VSIX....
- Select the downloaded
.vsix file.
Quick Start
- Install the extension from VS Code Marketplace or VSIX.
- Register: Open Command Palette →
MAIP: Register Developer → Enter email → Done!
- Protect: Right-click a file →
Protect with Truthlocks (or run MAIP: Create Receipt).
- Verify: Run
MAIP: Verify Receipt to check any attestation.
- Monitor: Status bar shows your usage. Activity Bar shows agents, receipts, delegations.
Requirements
- VS Code 1.85.0 or later
- Internet connection (for API calls to sandbox-api.truthlocks.com)
- No pre-existing account needed — register directly from the extension!
Links
License
Apache-2.0