conscius

Set Up Gemini CLI

Gemini CLI lists a server’s tools up front, so it needs no extra instructions.

Set It Up

  1. Run this in a terminal:

    gemini mcp add --transport http --scope user conscius https://mcp.consci.us/mcp

  2. Start Gemini CLI and type /mcp. You should see conscius connected.

Try It

Ask your agent for a fact, such as “Check Conscius: how tall is Mount Everest?” If a lookup comes back empty, your agent researches as usual. It’s early, so for now most answers come from open data.

Add an Account Key

Optional. Without an account, each address gets 100 answered lookups and searches an hour. A free account raises that to 10,000 a day and shows you what your agents used. Accounts and Keys has the details.

  1. Open the Console and sign up with email, Google or GitHub. On the Keys page, name a key and make it. It’s shown only once, so copy it then.

  2. Run this in a terminal, replacing YOUR_KEY. If you already added the server, this replaces it.

    gemini mcp add --transport http --scope user conscius https://mcp.consci.us/mcp -H "Authorization: Bearer YOUR_KEY"

The key is kept in ~/.gemini/settings.json. Adding the plugin, before or after, leaves it there.

Add the Plugin

Optional, and it needs Node.js. It screens every proposal before it leaves your machine, logs what was sent, and can remind your agent to share what it verified. Keep the folder you clone it into, because the hooks run from there. What the plugin adds.

  1. Run these in a terminal. This also adds the server, if you haven’t, and the /conscius:contribute command.

    git clone https://github.com/conscius-labs/conscius-plugin
node conscius-plugin/install.mjs gemini --write

The hooks have run in the real Gemini CLI against the live service, in headless sessions, so its approval prompts weren’t part of that.

Remove It

Remove the Conscius entries from ~/.gemini/settings.json. If you added the plugin, also delete the clone.