# A little extra headspace.

> Add optional capabilities when they help your work. Keep a clear view of what is installed, enabled, and allowed.

Canonical: https://headful.cloud/docs/extensions

## Start with the workspace.

Headful’s desktop core and Admin Utilities extension are open source under MIT. They work locally on your Mac; by default, your Salesforce data does not pass through Headful’s servers. The optional MCP Apps extension has a separate proprietary license and adds local agent setup and interactive interfaces for compatible clients. Headful Connect is a separate optional proprietary extension, disabled by default, currently in development. The Mac beta is currently free. Enabling an extension does not authenticate a Salesforce org or approve a write.

- [Inspect the open-source core](https://github.com/reachjalil/headful)
- [Why Headful runs locally](https://headful.cloud/why-local)

## Inspect before enabling.

The initial beta uses bundled extensions. A public extension marketplace is not available. Install only software supplied through a trusted release path.

1. Open Extensions in Headful.
2. Inspect the installed extension’s identity, version, compatibility, license, settings, and contributed features.
3. Enable it when you need its capabilities.
4. Disable it or revoke its agent grants when you no longer want it active.

## Use the public admin utilities.

Org shortcuts provide explicit workspace switching, supported Salesforce setup links, and per-org favorites. Record Inspector opens a lead from the core search or an object API name and record ID, then shows readable field labels, API names, types, and values. These are read-only tools: Salesforce permissions apply, and no utility operation grants additional access.

The SOQL workspace accepts read-only SELECT queries, suggests available objects and fields, and keeps saved queries and history with their original org. Results are bounded to a page of at most 500 loaded records; cancel an active request or export the loaded page as a local CSV. Schema Explorer describes available objects, fields, and relationships, prepares a selected-field starter query, and exports local Markdown field documentation.

Basic CLI diagnostics show supported limits, storage, recent jobs, and available debug logs. Missing permissions or unsupported CLI capabilities remain visible. Debug logs may contain CRM data; copy or share them only with that context in mind.

## Optional remote access, with clear boundaries.

Headful Connect is in private development. It pairs controlled mobile clients or hosted MCP integrations to an outbound connection from your Mac. Core local use remains free and requires no Headful account. Connect starts disabled and requires separate per-org remote opt-in and a Mac-confirmed client grant.

For our controlled client, encrypted application payloads pass through the relay; routing, device and grant metadata, message sizes, and timing remain visible. Hosted MCP clients use a different path: authorized requests and results are temporarily processed by the gateway. Salesforce CLI credentials and execution stay on your Mac in both Connect paths.

The current mobile journey is a responsive development client with a native secure-storage/foreground adapter. A distributed iOS app, store approval, and native ChatGPT acceptance are separate future steps. Public access remains behind the waitlist.

- [Read remote data handling](https://headful.cloud/privacy)

## Make the shared header yours.

The header follows active extension contributions and settings. Disabling an extension removes its unavailable controls. Header preferences never change the target org, and changing the default org does not retarget saved workflows or prepared changes.

1. Choose the explicit org target for the workspace. Its identity remains visible.
2. Open Customize header and choose global defaults or an override for this workspace.
3. Show or hide optional extension controls, move them into your preferred order, and save.
4. Reset global defaults or remove the workspace override to inherit them again.

## Know what is coming later.

This is a focused first utility slice, not a promise of complete Salesforce Inspector parity. Backups, snapshots, and reviewed restores are planned as a separate proprietary extension and have no implementation in the public Admin Utilities package. Bulk imports, advanced metadata operations, and broader orchestration remain future work. Check the current invitation for the capabilities in your build.

- [Set up a local agent](https://headful.cloud/docs/agents)
- [Join early access](https://headful.cloud/#waitlist)

## Early access

Headful is a free Mac beta, Salesforce first. Public stable distribution is not available yet. [Join early access](https://headful.cloud/#waitlist).