CLI-first workspace setup

Aurous

Productivity Resolved.

Workspace setup usually means choosing a structure, finding the right destination, and hand-building every object. Turn project context into a ready-to-use productivity workspace without learning the tool first.

Try the mock demo →See how it works

aurousresolved workflow

01 Inspect context read-only

02 Resolve workspace exact target

03 Preview every action review

04 Approve type apply

05 Build finished

How it works

One deliberate path from context to workspace.

Aurous is designed to be safe enough for a first run and exact enough for your real work.

Choose Codex or Claude Code

Pick the local AI command-line tool you already use.

Connect a productivity tool

Let your agent connect to Notion, Linear, Airtable, or Trello.

Give Aurous your project context

Use a project folder, copied notes, or a short summary.

Review the generated plan

Every planned write is printed before anything changes.

Type approval

Aurous waits for your explicit confirmation.

Receive a finished workspace

It applies only the plan you approved and records the result.

Rerun safely

Compatible exact matches are reused or skipped; ambiguous matches stop safely.

Setup guide

Start with the tools you already have.

The exact install flow below is taken from this project’s current documentation.

Operating system

Local agent

Install prerequisites

Use Node.js 20 or newer and npm 10 or newer.

node --version
npm --version

Install Aurous

Run these commands from the Aurous project folder.

npm install
npm run build
npm link

Authenticate Codex

codex login

Verify the installation

Check Node, agent readiness, local authentication, and available MCP connections.

aurous doctor --agent codex

Open help

See every available command and current model notes.

aurous --help

Connect productivity tools

Bring your existing workspace.

MCP is the connector that lets your local agent use a productivity tool. Aurous checks it before it plans.

Notion

Validated

CreatesPages, databases, properties, relations, statuses, and useful views.

ConnectConfigure the official Notion MCP in your local agent, then let Aurous inspect accessible pages read-only.

AuthenticationShare or create one Notion page for the connected account before your first plan.

aurous doctor --agent codex

Linear

Validated

CreatesProjects, milestones, issues, labels, priorities, and their relationships.

ConnectConfigure the official Linear MCP in your local agent, then let Aurous inspect available teams read-only.

AuthenticationAsk a workspace admin to grant the connected account access to a team.

aurous doctor --agent codex

Airtable

Validated

CreatesBases, tables, fields, records, and typed record relationships when supported by the connected MCP.

ConnectConfigure an official Airtable MCP in your local agent, then let Aurous check readiness before planning.

AuthenticationUse the MCP provider’s documented sign-in flow; Aurous never receives or stores credentials.

aurous doctor --agent codex

Trello

Validated

CreatesBoards, lists, cards, checklists, and approved card updates.

ConnectConfigure an official Trello MCP in your local agent, then let Aurous inspect the approved workspace read-only.

AuthenticationUse the MCP provider’s documented sign-in flow and grant access to the workspace you want to use.

aurous doctor --agent codex

Connection-specific setup commands are not published in the repository. Aurous never asks for, copies, or stores tool credentials.

Generate context

Tell Aurous what matters, in the format you already have.

Use an existing folder, copy a short brief from a web app, or export and summarize the parts of a GUI tool you want to plan from.

Existing project folder

Point Aurous at a project directory. It builds a bounded Context Pack and skips secrets, dependencies, and build output.

Copied web information

Paste a project brief, roadmap, or notes from a web app into a short source document.

Exported or summarized GUI work

Export the useful parts of a desktop tool, or ask your local agent to create a plain-language summary.

Context Pack prompts

Paste one into Codex and edit the bracketed details.

Software project

Create an Aurous Context Pack for this software project. Summarize the goal, current work, milestones, risks, people, and the next useful tasks. Keep it concise and structured.

Job search

Create an Aurous Context Pack for my job search. Summarize target roles, companies, application stages, contacts, follow-ups, deadlines, and next actions.

Content calendar

Create an Aurous Context Pack for this content calendar. Summarize audiences, channels, themes, publishing dates, assets, approvals, and next actions.

Product launch

Create an Aurous Context Pack for this product launch. Summarize the launch goal, owners, workstreams, dates, dependencies, risks, and next actions.

Personal planning

Create an Aurous Context Pack for my personal planning. Summarize priorities, commitments, routines, deadlines, and the next small actions.

Presets

Start from a useful shape.

Presets are editable prompt ideas—not automatic workflows.

Selected preset

Product HQ

Best destination: Notion
What it creates: A product home, roadmap, decisions, and linked work.

Sample context prompt

Build a Product HQ for this project with a roadmap, decisions, specs, and next actions.

Judge test path

Plan. Preview. Approve and apply.

For the fastest proof, run the built-in mock demo: it needs no accounts, no MCP setup, and makes no external writes. The repository includes the same concise path in its Judge Guide.

Plan

Read explicit context and create a saved, validated workspace plan.

aurous plan --agent codex --tool notion --context . --prompt "Create a workspace that helps me manage this project"

Preview

The plan is printed before any write. List saved runs when you are ready to inspect one again.

aurous runs

Approve and apply

Apply only the saved run you reviewed. In an interactive terminal, type apply when asked.

aurous apply <run-id> --yes

macOS

aurous plan --agent codex --tool notion --context . --prompt "Create a workspace that helps me manage this project"

Windows PowerShell

aurous plan --agent codex --tool notion --context . --prompt "Create a workspace that helps me manage this project"

Codex example

aurous plan --agent codex --tool linear --context . --prompt "Set up Linear for this project"

Claude Code example

aurous plan --agent claude --tool notion --context . --prompt "Create a workspace for this project"

Model selection

aurous plan --agent codex --model gpt-5.6-terra --tool notion --context . --prompt "Create a workspace"

Destination selection

aurous plan --tool linear --context . --prompt "Create a workspace"

You never need to manually find a workspace ID, page ID, team ID, board ID, or record ID during normal onboarding. Aurous resolves one safe destination or asks you to choose from friendly names.

Built for deliberate work

Safe by design.

Inspect before writing. Destination discovery is read-only.
Preview every action. The saved plan is the write allowlist.
Require typed approval. Nothing executes without it.
Use exact external IDs. Existing objects are verified before reuse.
Stop on ambiguity. Aurous never guesses which match you meant.
Rerun safely. Compatible exact matches can be reused or skipped.
Keep evidence. Run artifacts and redacted diagnostics remain local.

Built with Codex and GPT-5.6 for product planning, implementation, debugging, safety analysis, and integration validation.