jiang1997/context-port

A shared knowledge and context workspace for humans and AI agents, with native MCP and REST support.

TypeScript

4

68 commits

updated Oct 6, 2026

See the code

See what people are saying

SourceMessageScoreDate

I built an agent-friendly online clipboard (r/mcp)

[](https://www.reddit.com/r/mcp/?f=flair_name%3A%22showcase%22)I sometimes use web-based clipboard tools to share text. Since I also use AI coding agents a lot, I decided to vibe-code an agent-friendly online clipboard: **ContextPort**. It lets humans and agents share and update task context, with…

1

Oct 6, 2026

README

ContextPort

简体中文

Shared task context for humans and agents, with Markdown rendering and an English / Simplified Chinese Web app.

Try it online: context-port.vercel.app

  • Temporary Context: share short-lived content with a passphrase; no sign-in required. Expires after 7 days without access; each successful access renews it for another week.
  • Account Context / Thread: keep project knowledge in documents owned by your account. Sign in with Google; connect agents through REST or MCP with a personal API key.

Threads are focused documents, not chat messages. Account documents do not expire automatically.

Get started

Open the Web app and choose For Humans, then generate a passphrase or enter your own. Add content and use Copy Prompt to give an agent access. Anyone with the passphrase can read and modify the content.

For persistent documents, sign in with Google and create a Context. Create a personal key on API Keys (/keys) to connect an agent.

See the usage guide for access rules, editing, expiry, and current limits.

Run locally

Requires Node.js 24+, pnpm 12.4.2, and a running Docker engine. From the repository root:

# First setup only; preserve an existing .env.
cp .env.example .env
pnpm install
docker compose up -d postgres
# Wait until PostgreSQL reports accepting connections.
docker compose exec postgres pg_isready -U contextport -d context_port
pnpm db:migrate
pnpm build
pnpm dev

Open http://localhost:5173. Temporary Contexts work immediately; account features require Google login configuration.

Documentation

GuideContents
UsageContext types, Web workflow, permissions, and current limits
Agent accessREST endpoints, curl examples, MCP, and version conflicts
Local developmentEnvironment setup, Google login, and testing
DeploymentVercel / Render configuration and database migrations

Product design and planned work: note.md. Planned features are not all implemented.

License

MIT © 2026 jiang1997

agentic-ai
ai-agents
claude
context-management
human-in-the-loop
llm
mcp
model-context-protocol
nestjs
react

jiang1997/context-port

A shared knowledge and context workspace for humans and AI agents, with native MCP and REST support.

TypeScript

4

68 commits

updated Oct 6, 2026

See the code

See what people are saying

SourceMessageScoreDate

I built an agent-friendly online clipboard (r/mcp)

[](https://www.reddit.com/r/mcp/?f=flair_name%3A%22showcase%22)I sometimes use web-based clipboard tools to share text. Since I also use AI coding agents a lot, I decided to vibe-code an agent-friendly online clipboard: **ContextPort**. It lets humans and agents share and update task context, with…

1

Oct 6, 2026

README

ContextPort

简体中文

Shared task context for humans and agents, with Markdown rendering and an English / Simplified Chinese Web app.

Try it online: context-port.vercel.app

  • Temporary Context: share short-lived content with a passphrase; no sign-in required. Expires after 7 days without access; each successful access renews it for another week.
  • Account Context / Thread: keep project knowledge in documents owned by your account. Sign in with Google; connect agents through REST or MCP with a personal API key.

Threads are focused documents, not chat messages. Account documents do not expire automatically.

Get started

Open the Web app and choose For Humans, then generate a passphrase or enter your own. Add content and use Copy Prompt to give an agent access. Anyone with the passphrase can read and modify the content.

For persistent documents, sign in with Google and create a Context. Create a personal key on API Keys (/keys) to connect an agent.

See the usage guide for access rules, editing, expiry, and current limits.

Run locally

Requires Node.js 24+, pnpm 12.4.2, and a running Docker engine. From the repository root:

# First setup only; preserve an existing .env.
cp .env.example .env
pnpm install
docker compose up -d postgres
# Wait until PostgreSQL reports accepting connections.
docker compose exec postgres pg_isready -U contextport -d context_port
pnpm db:migrate
pnpm build
pnpm dev

Open http://localhost:5173. Temporary Contexts work immediately; account features require Google login configuration.

Documentation

GuideContents
UsageContext types, Web workflow, permissions, and current limits
Agent accessREST endpoints, curl examples, MCP, and version conflicts
Local developmentEnvironment setup, Google login, and testing
DeploymentVercel / Render configuration and database migrations

Product design and planned work: note.md. Planned features are not all implemented.

License

MIT © 2026 jiang1997

agentic-ai
ai-agents
claude
context-management
human-in-the-loop
llm
mcp
model-context-protocol
nestjs
react