{"_id":"@0x26/amp","_rev":"21-a779e6cfe823e259661409c44375f1e1","name":"@0x26/amp","dist-tags":{"latest":"0.5.6"},"versions":{"0.5.1":{"name":"@0x26/amp","version":"0.5.1","license":"UNLICENSED","_id":"@0x26/amp@0.5.1","maintainers":[{"name":"jdrez","email":"josh@withampersand.ai"},{"name":"7oeywang","email":"joey@withampersand.ai"},{"name":"akoripelly","email":"aarthi@withampersand.ai"}],"bin":{"amp":"dist/index.js"},"dist":{"shasum":"30437dfe04cd649407cc5aa73cd8d92017e74886","tarball":"https://registry.npmjs.org/@0x26/amp/-/amp-0.5.1.tgz","fileCount":4,"integrity":"sha512-wZ1dlJz8dlvEwNOG2sSL+Qxs4HosFnS3Xjhm20pI9RZLUWBYm47LTjTR5IoFSC0WiHJpazeVTE8gR//7Pw7rKw==","signatures":[{"sig":"MEUCIGkvpyVV5qIy+7eULqNbFjuBgoTWqWvY+Y3JVpZO/FEGAiEAsrtSZ1Ix71Fb6luWivEK1sawQNwE7cI5zM7Ve8eHP9w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":67428},"type":"module","engines":{"node":">=20"},"gitHead":"25d4d5d710e480bba01cd7813c7b3481ce40ca7d","_npmUser":{"name":"akoripelly","email":"aarthi@withampersand.ai"},"_npmVersion":"11.19.0","description":"Query your data with Ampersand","directories":{},"_nodeVersion":"24.21.0","dependencies":{"commander":"^12.1.0"},"publishConfig":{"access":"restricted"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amp_0.5.1_1788981680866_0.4779856752795433","host":"s3://npm-registry-packages-npm-production"}},"0.5.2":{"name":"@0x26/amp","version":"0.5.2","license":"UNLICENSED","_id":"@0x26/amp@0.5.2","maintainers":[{"name":"jdrez","email":"josh@withampersand.ai"},{"name":"7oeywang","email":"joey@withampersand.ai"},{"name":"akoripelly","email":"aarthi@withampersand.ai"}],"bin":{"amp":"dist/index.js"},"dist":{"shasum":"94c43e2c7d8e97a043c4a45cb37441e27284e974","tarball":"https://registry.npmjs.org/@0x26/amp/-/amp-0.5.2.tgz","fileCount":4,"integrity":"sha512-WYa0bNGmGusXb0VJz0/6VoEIYjJhF4kQ3z5KxjjRmi+1VpADrYrRwvXzxvN+Thb1lVU9Y150jlAObusjJWh/vA==","signatures":[{"sig":"MEUCIQDGbZcW7bwBiRRFfgO+nOiz7EkGZ3FyJYPFrMT957i6mAIge6HgkSYt8IDPjol55Msa6d29uLfrKEfbYpJLMobXNG4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCG6M8CLhAgISO27MSwJuLf55xCS1X+LBUXZ6Y7jNYxEwIhANO5BP+8kuZteHTpHYph3aMOKpRU6j9l17Fp62qcI86V","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":70830},"type":"module","engines":{"node":">=20"},"gitHead":"ebee433310e367a458c1784f27dc4eee8eb6c54a","_npmUser":{"name":"akoripelly","email":"aarthi@withampersand.ai"},"_npmVersion":"10.9.4","description":"Query your data with Ampersand","directories":{},"_nodeVersion":"24.21.0","dependencies":{"commander":"^12.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amp_0.5.2_1789252151086_0.13354335085123759","host":"s3://npm-registry-packages-npm-production"}},"0.5.3":{"name":"@0x26/amp","version":"0.5.3","license":"UNLICENSED","_id":"@0x26/amp@0.5.3","maintainers":[{"name":"jdrez","email":"josh@withampersand.ai"},{"name":"7oeywang","email":"joey@withampersand.ai"},{"name":"akoripelly","email":"aarthi@withampersand.ai"}],"bin":{"amp":"dist/index.js"},"dist":{"shasum":"d143007a98f964ef62d8870216f5deb5fa44db71","tarball":"https://registry.npmjs.org/@0x26/amp/-/amp-0.5.3.tgz","fileCount":4,"integrity":"sha512-cqO0mxowocq4mwXxfv2vYjtVzwDhS4EeygrdoPRnhtlgfHG/IYYEtQIZaPOd3f0h3CJixKk6Qi6ybUynq9/f/g==","signatures":[{"sig":"MEQCIFer64lElqpkBecSBtpDiRW2yVHrZOd4lzALTi9KYGMrAiAFvO7pIQ1CdAvIWzfgVRZFKEowlEspidwevyjuFyu6iQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCzuKX7Ww5dB9j6ds39Mf58hXRAz9eXKBBeJUP835+A5QIgRLaUwHT0JOYMVhA+/yhXmyaIFNGAz39OXhvM/BgNPMM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":78214},"type":"module","engines":{"node":">=20"},"gitHead":"e81af0f4fa3e0bc966cd1199408073a014fec644","_npmUser":{"name":"akoripelly","email":"aarthi@withampersand.ai"},"_npmVersion":"10.9.4","description":"Query your data with Ampersand","directories":{},"_nodeVersion":"24.21.0","dependencies":{"commander":"^12.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amp_0.5.3_1789253953207_0.8025276212156662","host":"s3://npm-registry-packages-npm-production"}},"0.5.4":{"name":"@0x26/amp","version":"0.5.4","license":"UNLICENSED","_id":"@0x26/amp@0.5.4","maintainers":[{"name":"jdrez","email":"josh@withampersand.ai"},{"name":"7oeywang","email":"joey@withampersand.ai"},{"name":"akoripelly","email":"aarthi@withampersand.ai"}],"bin":{"amp":"dist/index.js"},"dist":{"shasum":"32be8aca723330a8aaff1ef4eb135df5d8a843da","tarball":"https://registry.npmjs.org/@0x26/amp/-/amp-0.5.4.tgz","fileCount":4,"integrity":"sha512-EnghWNNlmwhC41Y1X7UCIjjCYddwDGjzNjM3aDpnuOc6Y7mrKuvZtcxPLkBeNZltOne6yrSSuLcEWOFQD4Xcfg==","signatures":[{"sig":"MEYCIQDFEegE7htip3/1kOKJamG9/GdI6lcXuqlbB2i2vMheVgIhAN1BBYH9YKGl7hhhXJMP0VpTgYQZTEMa77O0QJG2N26g","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQD8Mecj57tSewq6bXUGGk/VZPWkCaPVoqJrD6yVHCT+SAIhAMymAtICPPm2ETqiWpakWHrDewv8X50VjRvEUWzaLmdO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":90199},"type":"module","engines":{"node":">=20"},"gitHead":"e9f28b327fc6cb05b9296475e6b547071404b347","_npmUser":{"name":"jdrez","email":"josh@withampersand.ai"},"_npmVersion":"10.8.2","description":"Query your data with Ampersand","directories":{},"_nodeVersion":"20.20.2","dependencies":{"commander":"^12.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amp_0.5.4_1789581225158_0.9125213328893107","host":"s3://npm-registry-packages-npm-production"}},"0.5.5":{"name":"@0x26/amp","version":"0.5.5","license":"UNLICENSED","_id":"@0x26/amp@0.5.5","maintainers":[{"name":"jdrez","email":"josh@withampersand.ai"},{"name":"7oeywang","email":"joey@withampersand.ai"},{"name":"akoripelly","email":"aarthi@withampersand.ai"}],"bin":{"amp":"dist/index.js"},"dist":{"shasum":"2be744b976b54ab42773a77759fb5e13cf6ea52c","tarball":"https://registry.npmjs.org/@0x26/amp/-/amp-0.5.5.tgz","fileCount":4,"integrity":"sha512-/5zekiCDbTopaYIL07e9kk7rzrbIuOC7wwSCf2ALKzKF/FxZ2JwrFhYK7XvyFX7zwEj0s7Ejeb6cbIUjRHhjxQ==","signatures":[{"sig":"MEYCIQCfVPnD/nmOs0cGJdGHVjy7KF3A1YMhDgb+M7wcPKzmWAIhAKkIUHXxz8AR69LtlL4d2BQkZWDtbcjGfaoF3NS2CUzC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIHZTlpB8+gtiI0HzRF/kfYQ1RqxuB0n1kVysGlbYJ5zuAiEAoKPZTechCMdBIFe6GHmyw1hBbiewZBlqTfWZHY9qEiI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97635},"type":"module","engines":{"node":">=20"},"gitHead":"106efe57fdd8e045129fbc8cf0eace90af8e8910","_npmUser":{"name":"jdrez","email":"josh@withampersand.ai"},"_npmVersion":"10.8.2","description":"Query your data with Ampersand","directories":{},"_nodeVersion":"20.20.2","dependencies":{"commander":"^12.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/amp_0.5.5_1789590396967_0.33705235540758793","host":"s3://npm-registry-packages-npm-production"}},"0.5.6":{"_id":"@0x26/amp@0.5.6","bin":{"amp":"dist/index.js"},"dist":{"shasum":"a699dc3dd706377c1fc476f541d84af295f25603","tarball":"https://registry.npmjs.org/@0x26/amp/-/amp-0.5.6.tgz","fileCount":4,"integrity":"sha512-0A0j7Xs0g8Mya51JyEarWDO79qE/HhVdfQSJiCmhaJVB+OYoOq0HVIofu2uuBCx+SfIgy7nreKLiLnlMdNfnDw==","signatures":[{"sig":"MEUCIC56j6Pkr9dYEjGyL1W9M7dNUFhOVHu250UnbPAON+1rAiEAknSoZmTrUugviEqcMV0tklZ/BHUae75Taa/fTbxkWyM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDExSCo2Z5gBOCYdAi3MRYX4uFShhnmlohUpyFVs4xZZAIhAKdgPMxZcmAMuFwe3w8ZKDVBlmxBFVE3ADIFTX/kxb18"}],"unpackedSize":98928},"name":"@0x26/amp","type":"module","engines":{"node":">=20"},"gitHead":"e37587f8aa4d8a5fb2bcf311b81710ccf0a82e02","license":"UNLICENSED","version":"0.5.6","_npmUser":{"name":"jdrez","email":"josh@withampersand.ai"},"_npmVersion":"10.8.2","description":"Query your data with Ampersand","directories":{},"maintainers":[{"name":"jdrez","email":"josh@withampersand.ai"},{"name":"7oeywang","email":"joey@withampersand.ai"},{"name":"akoripelly","email":"aarthi@withampersand.ai"}],"_nodeVersion":"20.20.2","dependencies":{"commander":"^12.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/amp_0.5.6_1789594765153_0.07210835240694058"}}},"time":{"created":"2026-09-09T19:21:20.601Z","modified":"2026-09-16T21:39:25.452Z","0.1.0":"2026-06-24T20:51:34.194Z","0.1.1":"2026-06-25T22:12:41.130Z","0.2.0":"2026-06-26T00:39:56.179Z","0.2.1":"2026-06-26T20:53:32.301Z","0.2.2":"2026-06-29T17:13:29.421Z","0.3.0":"2026-08-31T02:09:06.228Z","0.4.0":"2026-08-31T19:25:05.008Z","0.4.1":"2026-08-31T21:11:51.480Z","0.4.2":"2026-08-31T21:25:45.730Z","0.4.3":"2026-09-01T20:50:33.503Z","0.4.4":"2026-09-09T18:58:18.059Z","0.5.1":"2026-09-09T19:21:21.007Z","0.5.2":"2026-09-12T22:29:11.181Z","0.5.3":"2026-09-12T22:59:13.285Z","0.5.4":"2026-09-16T17:53:45.258Z","0.5.5":"2026-09-16T20:26:37.064Z","0.5.6":"2026-09-16T21:39:25.238Z"},"license":"UNLICENSED","description":"Query your data with Ampersand","maintainers":[{"name":"jdrez","email":"josh@withampersand.ai"},{"name":"7oeywang","email":"joey@withampersand.ai"},{"name":"akoripelly","email":"aarthi@withampersand.ai"}],"readme":"# Ampersand CLI\n\nCommands: `login`, `schema`, `sql`, `ask`, and `skill`. Requires Node.js 20 or later.\n\n```sh\nnpm install -g @0x26/amp\namp login --store https://YOUR-TENANT-STORE --install-skill\namp login --status\namp schema\namp ask \"What data is available to me?\"\n```\n\nYour administrator supplies the tenant store URL. Browser sign-in authorizes data\naccess; installing the package does not grant access. Ask must be enabled for your tenant.\n\n- `amp schema [type]`: authorized object types and columns; the `table` field names the SQL view.\n- `amp sql \"SELECT ...\" --json`: read-only SQL; `--out <file>` saves results.\n- `amp ask \"question\"`: answer, evidence, and limitations; `--help` lists conversation controls.\n- `amp login --logout`: remove the selected local session. It does not revoke sessions on other devices.\n- `amp --profile <name> ...`: select a saved tenant; use `login --name <name>` when signing in.\n\nCredentials are stored under `~/.config/amp` with user-only permissions. The skill\nis bundled as `skill/SKILL.md`; the setup flag installs it under\n`~/.claude/skills/amp-cli/SKILL.md`. Copy the bundled file to your agent's skill\ndirectory for other agent environments. Do not include credentials in skill files.\n\nFor a package archive supplied by your administrator, install with\n`npm install -g ./amp-customer-VERSION.tgz`, then follow the same login steps.\n\nUse `npm install -g @0x26/amp@VERSION` for a reviewed update. Query result\nwarnings report incomplete results; do not treat them as a complete data export.\n\n## Humans and agents\n\n- In a terminal, results are readable previews. Piped output defaults to agent JSON.\n- `--agent`: one `{ \"data\": ..., \"meta\": { \"version\": 1, ... } }` response; no prompts or routine progress. Errors return `{ \"error\": { \"code\", \"message\", \"retryable\", \"next_command\"? } }` and a nonzero exit code.\n- `--human`: force readable output. `--quiet`: hide routine progress. `--no-input`: never start browser sign-in or wait for input.\n- `--json`: preserve the original raw JSON shape for existing scripts. Select one output mode per command.\n- `--out <file>` saves returned results and prints a receipt; agent mode writes an envelope to both the file and the receipt. SQL metadata identifies partial results and the next action. A file does not remove server result limits.\n- Agent mode changes output, not identity or permissions. A person signs in; their local agent uses the same authorized session.\n\n```sh\namp --agent login --status\namp --agent schema\namp --agent sql 'SELECT 1 AS example'\namp --human ask 'What data is available to me?'\n# Install the skill separately, without browser sign-in:\namp login --install-skill --skill-dir ~/.codex/skills/amp-cli\n```\n\nThe default skill destination is Claude Code. Use `--skill-dir` for any agent's\nskill directory. Existing hand-edited skill files are preserved. Start a new\nagent session after installing the skill.\n\nAsk answers include numbered sources and limitations. When the workspace has\nevidence links configured, minute sources include a URL to the supporting\nentry. “Preview unavailable” keeps the original source reference without a link.\nUse `amp --agent ask \"<question>\"` for structured evidence and preview metadata.\n\nAsk uses your signed-in account for “me” and your computer's timezone for “today”.\nOverride the timezone with `amp ask --timezone America/Los_Angeles \"My activity today\"`.\nYour workspace needs an Ask service that supports timezone context. Sources and\navailable evidence URLs appear below human-readable answers; structured output\nretains the evidence metadata. A source can lack a preview when no supporting\nminute entry is available.\n\n### Reading Ask answers in your terminal\n\nInteractive terminals open an answer reader with Sources and Limitations collapsed.\nUse arrow keys to scroll, Enter to expand a section or open a source, `s`/`l` to\ntoggle sections, and `q` or Ctrl-C to close the reader. Supported terminals also\nallow clicking section rows and citations. Inline `[1]` references use terminal\nhyperlinks; your terminal may require its normal link modifier. Expanded sources\nretain full URLs for copying when hyperlinks or browser launching are unavailable.\n\nUse `amp ask --plain \"question\"` for the full printable answer and sources without\nthe reader. Piped output, `--json`, and `--agent` keep their existing formats.\nThe reader requires both terminal input and output and is disabled for `TERM=dumb`.\nClosing it leaves a compact answer and a command for replaying full source URLs.\n\n## Install once, refresh published instructions\n\nYour administrator supplies the **Ask service origin** (distinct from the ontology\nstore URL). Install a small bootstrap once:\n\n```sh\namp skill install --service https://YOUR-ASK-SERVICE\n# Or choose the skill directory your agent reads:\namp skill install --service https://YOUR-ASK-SERVICE --dir ~/.agents/skills/amp-cli\namp --agent skill fetch --service https://YOUR-ASK-SERVICE\n```\n\nThe bootstrap fetches `/skill.md` directly on first use in a chat. There is no\nontology lookup or authentication for this public, generic instruction file.\nSkill changes ship with Ask deployments, independently of CLI releases. Existing\nchats retain their loaded instructions until explicitly refreshed. Changes to\nCLI capabilities or bootstrap discovery still require an update.\n\nFetch has a five-second deadline and 64 KiB limit, refuses redirects, and sends\nno credentials. It revalidates a publisher-scoped cache with ETags; offline or\nolder services fall back to the last valid cached skill, then the bundled skill.\nAgent output reports `source`, `stale`, `version` (SHA-256), and any warning.\nHand-edited local skills are preserved. Installation without `--service` retains\nthe bundled, offline skill behavior.\n\nInstalling to the Claude Code default location (`amp skill install` or\n`amp login --install-skill`, without `--dir`/`--skill-dir`) also adds a\n`SessionStart` hook to `~/.claude/settings.json` for new and cleared sessions. It\nruns `amp --agent skill sync`, which installs the latest `@0x26/amp` when the\nregistry has a newer version, refreshes the installed skill (the updated binary\ndoes this after an upgrade), and pre-fetches the published skill when one is\nconfigured. The hook is added once, other settings are preserved, and an\nunparseable settings file is left untouched. `AMP_NO_UPDATE_CHECK=1` skips the\nversion check. Other agents can run `amp --agent skill sync --dir <skill-dir>`.\n`amp login --install-skill --skill-service https://YOUR-ASK-SERVICE` installs the\nrefreshing skill during sign-in.\n\nRelated follow-ups and corrections automatically use the current Amp conversation\nunder the skill instructions. Agent Ask output includes `meta.continuation` with\ncommand arguments, profile, store, and conversation ID. Append the question as one\nargument; never concatenate it as shell code. Keep this state in the current chat,\nnot a machine-wide “last conversation.” Presentation-only edits need no new Ask.\nRaw `--json` output remains unchanged. This guides agent routing; it does not force\narbitrary LLMs to follow instructions or guarantee behavior after lost context.\n","readmeFilename":"README.md"}