Pi Agent: Session Management

from pi_agent import Agent, Session

session = Session(name="project_review")
agent = Agent(name="reviewer", session=session)

agent.chat("Review main.py")
agent.chat("What security issues are there?")

print(len(session.messages))  # 4 (2 مستخدم + 2 وكيل)

from pi_agent import Agent

agent = Agent(name="tutor")
agent.chat("Teach me Python decorators")

agent.session.save("decorator_session.json")

from pi_agent import Agent

agent = Agent(name="tutor")
agent.session.load("decorator_session.json")

agent.chat("How does it differ from class method decorators?")

agent = Agent(name="tutor", auto_save=True, save_dir="./sessions/")

from pi_agent import Agent

agent = Agent(name="architect")
agent.chat("Design a user authentication system architecture")
# الوكيل قدم نهج JWT

branch1 = agent.branch(name="jwt_branch")

agent.chat("Redesign using OAuth2")
# الوكيل قدم نهج OAuth2

branch1.chat("How to handle token refresh in JWT?")

# جلستان مستقلتان
print(agent.session.messages)       # مسار JWT -> OAuth2
print(branch1.session.messages)     # مسار JWT -> refresh

pi-agent sessions list
pi-agent sessions show decorator_session
pi-agent chat --session decorator_session
pi-agent sessions delete old_session
pi-agent sessions export decorator_session --format markdown --output chat.md

agent.session.add_tag("python")
agent.session.add_tag("decorator")
agent.session.add_tag("advanced")

from pi_agent import SessionManager

manager = SessionManager()
sessions = manager.find_by_tag("python")
sessions = manager.find_by_date("2026-08-28")
sessions = manager.search("decorator closure")

pi-agent sessions search "decorator"
pi-agent sessions list --tag python --date 2026-08-28

agent.session.export("chat.md", format="markdown")

agent.session.export("chat.json", format="json")

new_agent = Agent(name="continuer")
new_agent.session.import_from(agent.session)
new_agent.chat("Continue the discussion, dive deeper into metaclasses")