← Back to Skills Marketplace
Surface Cli
by
Vishal Jain
· GitHub ↗
· v0.3.5
· MIT-0
185
Downloads
0
Stars
0
Active Installs
9
Versions
Install in OpenClaw
/install surface-cli
Description
Use the Surface mail CLI to read and act on Gmail and Outlook mail through one JSON-first contract. Prefer this skill when you need Outlook access for school...
Usage Guidance
This skill appears to do what it says: it drives the 'surface' CLI to access Gmail/Outlook and stores state in ~/.surface-cli. Before installing or granting the agent autonomous access: 1) Inspect the npm package and source (the SKILL points to a GitHub repo) — check package.json scripts and recent commits; npm install can run arbitrary code. 2) Manually run and test 'surface' commands yourself (account add, auth login, fetch-unread) to confirm behavior before allowing an agent to run them. 3) Be cautious about enabling summarization/backends: the SKILL warns that enabling an external summarizer may send email content to a third-party model provider — only enable with explicit user consent. 4) Verify the CLI’s storage location (~/.surface-cli) and review stored tokens/credentials; treat those as sensitive. 5) If you need stronger assurance, request the exact npm tarball SHA or a signed release, or run the install in an isolated environment first. Note: metadata shows a minor version mismatch between the manifest (0.3.2) and the registry metadata (0.3.5); confirm you are installing the intended version.
Capability Analysis
Type: OpenClaw Skill
Name: surface-cli
Version: 0.3.5
The skill provides a legitimate interface for the 'surface-cli' tool to manage Gmail and Outlook accounts. The SKILL.md file includes comprehensive safety guidelines, explicitly instructing the agent to respect local write-safety policies, obtain user consent before enabling privacy-sensitive summarization features, and use draft modes for testing. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description, required binary ('surface'), and the install spec (npm package 'surface-cli' that creates the 'surface' binary) align. The skill's declared purpose (Gmail/Outlook via a JSON CLI) reasonably requires the listed binary and local state.
Instruction Scope
SKILL.md contains only surface CLI commands and guidance for account setup, polling, and thread watching. It references the local config/state directory (~/.surface-cli) and warns about optional summarization backends that may send thread content to external model providers. The instructions do not direct reading of unrelated system files or unrelated credentials, but they do rely on local auth tokens and local state.
Install Mechanism
Installation is via npm (package 'surface-cli'), which is an expected and reasonable distribution method for a CLI distributed as a Node package. npm installs can run package install scripts and introduce arbitrary code on install — a moderate risk. No direct downloads from arbitrary URLs or extract-from-unknown-host steps are present.
Credentials
The skill declares no required environment variables or external credentials. It does require the user to authenticate accounts (Gmail/Outlook) through the CLI; those tokens are stored locally under ~/.surface-cli. That is proportionate to an email CLI.
Persistence & Privilege
always is false, and the skill does not request system-wide privileges or attempt to modify other skills. The CLI will store local state in ~/.surface-cli (expected for an email client). Autonomous invocation is allowed (platform default) but not a special privilege of this skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install surface-cli - After installation, invoke the skill by name or use
/surface-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.5
Add watcher recipes, polling cadence guidance, and passive-watch vs triage read-state guidance; publish from synced OpenClaw workspace skill copy.
v0.3.4
Add watcher recipes, polling cadence guidance, and passive-watch vs triage read-state guidance; republish from committed skill state.
v0.3.3
Add watcher recipes, polling cadence guidance, and read-state rules for passive watching vs unread triage.
v0.3.2
Clarify summarization as user-controlled opt-in and remove model-specific config edit guidance.
v0.3.1
Republish with explicit install metadata and clearer local credential/config guidance.
v0.3.0
Adds GPT-5.4 mini summaries, ME-scoped action flags, warm Outlook sessions, thread refresh/search improvements, and parallel-read guidance.
v0.2.0
Add thread refresh and structured mail search filters
v0.1.1
Refresh ClawHub metadata and install guidance
v0.1.0
Initial Surface CLI skill release
Metadata
Frequently Asked Questions
What is Surface Cli?
Use the Surface mail CLI to read and act on Gmail and Outlook mail through one JSON-first contract. Prefer this skill when you need Outlook access for school... It is an AI Agent Skill for Claude Code / OpenClaw, with 185 downloads so far.
How do I install Surface Cli?
Run "/install surface-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Surface Cli free?
Yes, Surface Cli is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Surface Cli support?
Surface Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Surface Cli?
It is built and maintained by Vishal Jain (@vishalj99); the current version is v0.3.5.
More Skills