{"_id":"@apilium/altretta-bridge","name":"@apilium/altretta-bridge","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@apilium/altretta-bridge","version":"1.0.0","description":"One-command stdio bridge to the local Altretta MCP endpoint: connect Codex CLI and other stdio-only agents to your second brain.","type":"module","bin":{"altretta-bridge":"bin/altretta-bridge.mjs"},"engines":{"node":">=18"},"keywords":["altretta","mcp","mcp-remote","second-brain","knowledge-base","codex","stdio","bridge"],"repository":{"type":"git","url":"git+https://github.com/ApiliumCode/altretta-skill.git","directory":"bridge"},"homepage":"https://apilium.com/en/products/altretta","bugs":{"url":"https://github.com/ApiliumCode/altretta-skill/issues"},"author":{"name":"Apilium","url":"https://apilium.com"},"license":"MIT","gitHead":"8e541b068e6a2da8879905dcd951ce584804ec7d","_id":"@apilium/altretta-bridge@1.0.0","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-s6IVrlAVgwic3mQTXSsTyFTVLvaPbHXy5WXcpMesi6oPjRNFr56IKHNaLxJ6fuW1qoHAau36QK+dvVSOQsK7Jg==","shasum":"40775c2c8d7fd26ce2ad004a84e79a9faf802da0","tarball":"https://registry.npmjs.org/@apilium/altretta-bridge/-/altretta-bridge-1.0.0.tgz","fileCount":4,"unpackedSize":5370,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDcHptYS2A55jg0w/MkdU7poS6T8l0ShIzC4E6DEvsUbAiEA9ar4qS8xgAHiW7Cl+UtOzc/pBj4VHDoD5QicMKyXVhg="}]},"_npmUser":{"name":"apilium-ai","email":"it@apilium.com"},"directories":{},"maintainers":[{"name":"apilium-ai","email":"it@apilium.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/altretta-bridge_1.0.0_1785414577341_0.43756889968725954"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-30T12:29:36.960Z","1.0.0":"2026-07-30T12:29:37.466Z","modified":"2026-07-30T12:29:38.730Z"},"maintainers":[{"name":"apilium-ai","email":"it@apilium.com"}],"description":"One-command stdio bridge to the local Altretta MCP endpoint: connect Codex CLI and other stdio-only agents to your second brain.","homepage":"https://apilium.com/en/products/altretta","keywords":["altretta","mcp","mcp-remote","second-brain","knowledge-base","codex","stdio","bridge"],"repository":{"type":"git","url":"git+https://github.com/ApiliumCode/altretta-skill.git","directory":"bridge"},"author":{"name":"Apilium","url":"https://apilium.com"},"bugs":{"url":"https://github.com/ApiliumCode/altretta-skill/issues"},"license":"MIT","readme":"# @apilium/altretta-bridge\n\nOne-command stdio bridge to your local [Altretta](https://apilium.com/en/products/altretta) second brain. For agents that speak MCP over stdio only (Codex CLI and compatibles); HTTP-native runtimes should point straight at the endpoint instead.\n\n## Use\n\n```bash\nnpx -y @apilium/altretta-bridge --token <TOKEN>\n```\n\nOr set the token once and drop the flag:\n\n```bash\nexport ALTRETTA_MCP_TOKEN=<TOKEN>       # or write it to ~/.altretta/mcp-token\nnpx -y @apilium/altretta-bridge\n```\n\nCreate the token in the Altretta app: Settings, \"AI & connections\", \"Access tokens\". One token per agent: revoke one, the rest keep working.\n\n## Codex CLI example\n\n`~/.codex/config.toml`:\n\n```toml\n[mcp_servers.altretta]\ncommand = \"npx\"\nargs = [\"-y\", \"@apilium/altretta-bridge\"]\nenv = { ALTRETTA_MCP_TOKEN = \"<TOKEN>\" }\n```\n\n## What it does\n\nResolves your token (argument, then `ALTRETTA_MCP_TOKEN`, then `~/.altretta/mcp-token`) and runs `mcp-remote` against `http://127.0.0.1:19191/mcp` with the bearer header.\n\n`ALTRETTA_MCP_URL` overrides the endpoint. Add a second entry pointing at `http://127.0.0.1:19191/mcp-code` to give a stdio agent Altretta's code tools too — the same token authorizes both.\n\nIf it fails to connect, either Altretta is not running, or it is running with no access token: revoking the last one leaves the endpoint closed until you create a new token and restart the app.\n\nPart of the [Altretta Skill](https://github.com/ApiliumCode/altretta-skill). MIT licensed.\n","readmeFilename":"README.md","_rev":"1-14b708ff60509fdf47dd2c816700f3d3"}