shell

An interactive AI chat shell built with Next.js and the OpenAI Responses API.

Prerequisites

• Node.js 20.9 or later
• npm
• An OpenAI API key

Setup

npm ci
cp .env.example .env.local

Set OPENAI_API_KEY in .env.local, then start the application:

npm run dev

Open http://localhost:3000.

Commands

Command	Purpose
npm run dev	Start the development server
npm run build	Create a production build
npm run start	Serve a production build
npm run format	Format supported files
npm run format:check	Check formatting without changes
npm run lint	Run ESLint, including typed deprecation checks
npm run typecheck	Check TypeScript without emitting files

The current shell has no authentication, rate limiting, or usage quotas. Do not expose it publicly as a production service without abuse protection and cost controls.

Read the developer documentation, starting with the architecture for runtime boundaries and data flow.

License

MIT