get-cookie

Appearance

Getting started ​

Before you start ​

You need:

  • Node.js 20, 22, 24, 25, or 26, or Bun
  • A supported browser profile with the cookie already stored
  • Permission to read that profile and its encryption key

Cookie values are credentials. Use examples with accounts you control, keep the output local, and do not commit or paste it into shared logs.

Install the CLI ​

bash
pnpm add -g @mherod/get-cookie

You can use npm instead:

bash
npm install -g @mherod/get-cookie

Run a first query ​

The positional form is get-cookie [name] [domain] [options]:

bash
get-cookie sessionid example.com

Use % to match every cookie name for a domain:

bash
get-cookie % example.com --output json

To check whether one known local session is readable without displaying its value, use a status-only pipe:

bash
if get-cookie sessionid app.example.com | grep -q .; then
  echo "matching cookie is readable"
else
  echo "sign in first" >&2
fi

--render is useful for inspecting the CLI's serialized output, but it is not a safe generic outgoing-request helper. A domain query does not prove exact destination applicability, and --url expansion includes every parent domain without stopping at public suffixes such as co.uk.

If several profiles may contain the same cookie, list profiles first and then select one:

bash
get-cookie --browser chrome --list-profiles
get-cookie sessionid example.com --browser chrome --profile "Work"

See the CLI reference for every supported flag and the exact output modes.

Install the library ​

bash
pnpm add @mherod/get-cookie
typescript
import { getCookie } from "@mherod/get-cookie";

const cookies = await getCookie({
  name: "sessionid",
  domain: "example.com",
});

const first = cookies[0];
if (first) {
  console.log(first.name, first.domain);
}

Both name and domain are required. A missing cookie or an unreadable browser returns an empty array, so always handle that case.

Use Library usage for batch queries, runtime-specific entrypoints, and direct browser strategies.

Next steps ​