Pointed Back
FASTEST SETUP

Let your coding agent set it up.

Paste this into Codex, Claude Code, Cursor, or any coding agent that can edit files and run terminal commands. It will do the routine work and pause when you need to authorize Linear or add a secret.

One prompt, then follow alongYour agent will ask before it needs access or a secret.
Set up Pointed for me from https://github.com/jcb79107/pointed.

Please:
1. Clone or open the repository and read README.md and .env.example.
2. Install its dependencies.
3. Help me create a public Linear OAuth application. Use http://localhost:3000/api/auth/linear/callback as its callback URL.
4. Follow docs/launch/DATABASE-ISOLATION.md to migrate with DATABASE_ADMIN_URL and provision the restricted DATABASE_URL and AUTH_DATABASE_URL roles. Keep the admin connection local.
5. Configure APP_URL, LINEAR_CLIENT_ID, LINEAR_REDIRECT_URI, and TOKEN_ENCRYPTION_KEY in .env.local, then start the app locally. Pusher is optional.
6. Verify that the homepage loads and that the Connect Linear flow reaches Linear OAuth.

Never print or commit secrets. When I must authorize an account, click a web form, or paste a secret, pause and tell me exactly what to do in plain language. Otherwise, handle the setup yourself.
Prefer to set it up yourself?

You need Node.js, a Linear account, and a Postgres database. These steps take you from a fresh clone to a running app.

  1. 1
    Download and install

    Clone the repository, open it in a terminal, then run:

    npm install
  2. 2
    Create a Linear OAuth app

    Open the pre-filled form, create the public app, and copy its client ID. The callback URL is http://localhost:3000/api/auth/linear/callback.

    Open the Linear form
  3. 3
    Create a Postgres database

    A free Neon database is a simple option. Copy its pooled connection string; any compatible Postgres database works.

  4. 4
    Add the app settings

    Copy .env.example to .env.local, then fill in these required values:

    DATABASE_URL AUTH_DATABASE_URL LINEAR_CLIENT_ID TOKEN_ENCRYPTION_KEY
  5. 5
    Create the tables and start the app

    Follow the database isolation setup to migrate and provision the two restricted connections. Keep the admin connection out of your deployment.

    npm run dev

    Open http://localhost:3000, then connect Linear.